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PREFACE 


MANUAL OBJECTIVES 


The VAX/VMS System Dump Analyzer Reference Manual contains information 
useful in determining the cause of a VAX/VMS operating system failure. 





INTENDED AUDIENCE 

This reference manual is intended for users who possess extensive 
knowledge of VAX/VMS data structures. It assumes that the audience 
for this manual includes VAX/VMS developers and DIGITAL Software 


Support Specialists, as well as DIGITAL customers familiar with 
VAX/VMS internal design. 


In addition, system programmers who are writing device drivers’ may 
need to use SDA. The syStem manager should also become familiar with 


SDA, uSually to produce SDA listings after each crash and, more 
importantly, to save the system dump file for later analysis. 


STRUCTURE OF THIS DOCUMENT 
This reference manual consists of seven chapters: 


e Chapter 1 provides an introduction to SDA and summarizes’ SDA 
operations. 


e Chapter 2 describes the system dump file that SDA analyzes. 


e Chapter 3 explains how to run SDA to analyze a dump file or 
examine the running system. 


e Chapter 4 details the SDA command format. 
e Chapter 5 describes the SDA commands, in alphabetical order. 


e Chapter 6 gives guidelines for analyzing system failures’ and 
steps through a sample system crash. 


e Chapter 7 lists and explains the messages related to SDA 
operation. 


ASSOCIATED DOCUMENTS 


This document has the following prerequisites: 


VAX-11/780 Hardware Handbook 


VAX/VMS Summary ‘Description ‘and Glossary 


lenencemenendntetimbrreviehise eqersceeesremererseeyencrnenttcteh sec anilnteteT ie Ao 


The following documents are associated with this manual: 


VAX-11 Run-Time Library Reference Manual 


VAX/VMS Guide Guide to wean a a Device Driver 


en renting iste neem esata hme pmlc Rape eit tray ray Reine — 1h: enamemeaae nn: Se ambt 





or eeieeeancnnermetian’ takin memeenesie 


VAX/VMS System Manager ' 's Guide 











For a complete list of all 


descriptions of each, 


CONVENTIONS USED IN THIS DOCUMENT 


VAX-11 
see the VAX-11 Information Directory and Index. 


documents, including brief 


The following conventions are used in this document. 


Convention 


SHOW CRASH 


symbol-name 


name 


SET PROCESS | INDEX = 
/SYSTEM 


nn 





SHOW SYMBOL TEN 
TEN = QOOO0O00OL0 


Meaning 

Uppercase words and letters, used 
in examples, indicate that you 
should type the word or letter 
exactly as shown. 

Lowercase words and letters, used 
in format examples, indicate that 
you are to substitute a word or 
value of your choice. 

Square brackets indicate that the 
enclosed argument is optional, 
except for brackets used in 
directory specifications. 

Braces are used to enclose lists 
from which one element is to be 
chosen. 


A vertical ellipsis indicates that 


not all of the statements in an 
example or figure are shown. 
In examples of commands you enter 


and SDA responses, all output lines 
and prompting characters that SDA 
prints or displays are shown in 
black letters. All the lines you 
type are shown in red letters. 


A symbol with a l- to 3-character 


abbreviation indicates that you 
press a key on the terminal. 


V1 


CHAPTER 1 . 


INTRODUCTION TO SDA 


The System Dump Analyzer (SDA) is a VAX/VMS utility that aids in 
determining the cause of an operating system failure. 


When an internal error occurs that interferes with normal operations, 
the operating system writes information concerning its status at the 
time of the system failure to a predefined system dump file. SDA 
examines and formats the contents of this file. 
With the help of the SDA commands, you can display parts of the 
formatted system dump file ona video display terminal, or you can 
create hard copy listings. 
SDA performs the following operations: 

e Assigns a value to a symbol 

e Examines memory of any process 

e Formats block of data 

e Displays device data structures 

e Displays memory management structures 

e Displays a summary of all processes on the system 

e Displays the SDA symbol table 

e Copies the system dump file 

e Sends output to a file or device 

@e Reads symbols from any object module 
In addition to analyzing the system dump file, SDA can perform the 
operations listed above on a running system without interrupting that 
system's operation. 
While SDA provides a great deal of information, it does not analyze 
all the various control blocks and data contained in memory. 
Therefore, in the event of system failure, it is extremely important 


that customers send a copy of the system dump file to DIGITAL along 
with a Software Performance Report (SPR). 


CHAPTER 2 


THE SYSTEM DUMP FILE 


Before the VAX/VMS operating system can write information to the 
system dump file, the system parameter DUMPBUG must be set. Normally, 
this parameter is enabled by default; to reset DUMPBUG, as well as 
other system parameters, consult the VAX/VMS System Manager's Guide. 
If the DUMPBUG parameter is set and the operating system fails, the 
system writes the contents of the error log buffers, processor 
registers, and physical memory to the contiguous file SYSDUMP.DMP. 
SDA analyzes this file and produces formatted displays of its 
contents. 


SYSDUMP.DMP is furnished as an empty file in the VAX/VMS-~ software 


distribution kit. It is located in the system directory [SYSEXE] and 
its file size is initially small. 


2.1 SETTING THE SYSTEM DUMP FILE SIZE 
To preserve the continuity of the error log file and save all of 
physical memory, it is important to make sure that the dump file's 
size in blocks matches the individual system configuration. 
To change the size of SYSDUMP.DMP, the system manager (or a user with 
Similar privileges) runs a command procedure in the directory [SYSUPD] 
called SWAPFILES.COM. The command line is: 

4 OCSYSUPDISWAFRF TILES 


The command procedure prompts you for paging, Swapping, and dump file 


sizes. You can enter a new file size or simply press (@& . If you 
enter a new file size, the command procedure creates a new system dump 
file. This new file will not be used by the operating system until 


after a system reboot. 


To calculate the correct dump file size for your configuration, use 
the formula: 


blocks = physical-memory-size-in-pages + 4 


The four additional blocks store hardware context and error log 
buffers. You can also use the table provided in the VAX/VMS System 
Manager's Guide to find the correct size. This table Tists 
recommended sizes for the three files affected by the SWAPFILES 
command procedure. The system manager's guide also gives detailed 
information on SWAPFILES.COM and on changing dump file size. 


THE SYSTEM DUMP FILE 


2.2 SAVING SYSTEM DUMP FILES 


Every time the operating system writes information to SYSDUMP.DMP, it 
writes over whatever was previously stored in the file. For this 
reason, the system manager should save the contents of SYSDUMP.DMP 
after a system failure has occurred. One way to accomplish this is to 
copy the file to another directory. Use the DIGITAL Command Language 
(DCL) command COPY, as shown in the following example: 


$6 CORY SYS#SYSTEMISYSOUMF. DUMPS. CSYSERRISAVENUMP . DMF 


SDA also provides a COPY command. This command can be included in the 
series of SDA commands in the site-specific start-up procedure. 
Section 3.6 discusses the start-up procedure in more detail. The COPY 
command is explained in Chapter 5. 


CHAPTER 3 


RUNNING SDA 


SDA can analyze a dump file or examine the running system. To make it 
possible for SDA to read the dump file, you need: 


@e Read access to SYSDUMP.DMP 
e Read access to a copy of the system symbol table 


e Enough virtual space for SDA to map the entire system dump 
file 


To ensure that SDA has the correct amount of virtual address space, 
the running system must have the syStem parameter VIRTUALPGCNT equal 
to the size of the dump file plus 1000 pages. In addition, your page 
file quota (PGFLQUOTA in the user's authorization record created by 
running the User Authorization Program) must be at least the size of 
the dump file plus 1000 pages. See the VAX/VMS System Manager's Guide 
for information on system parameters and the User Authorization 
Program (AUTHORIZE). 


3.1 INVOKING SDA WITH THE RUN COMMAND 


If the above conditions are satisfied, you can invoke SDA by typing 
the following DCL command: 


$ RUN SYS#SYSTEMs SUA 


When you issue this command, SDA will prompt for the name of the 
system dump file you want to examine: 


Eater mame of chun Palle 


To examine the most recent system dump (SYSSSYSTEM:SYSDUMP.DMP), press 
(RET) in response to the prompt. SDA will search the system directory 
(logical name SYSSSYSTEM) for SYSDUMP.DMP. To examine an older dump 
file, enter its file specification: 


Enter mame of dume file & CWEZARDIACE CRASH, IMF 


The default file specification for the system dump file is 
SYSSDISK: [default-dir]SYSDUMP.DMP where SYSSDISK and  [default-dir] 
represent, respectively, the device and directory specified by the 
last SET DEFAULT command. (See the VAX/VMS Command Language User's 
Guide for a description of the SET DEFAULT command.) 


RUNNING SDA 


If you want to examine the running system, type an asterisk (*) in 
response to the dump file prompt. See Section 3.3 for further 
details. 


3.2 INVOKING SDA AS A FOREIGN COMMAND 


You can also invoke SDA as ae foreign command by using the DCL 
assignment statement: 


+ SA %= $STIA 


A foreign command is a command not known to the command interpreter 
that can be executed by entering a command string. 


The dollar sign ($) indicates to DCL that the expression is a_ foreign 
command. Now you can specify a file or the asterisk as a parameter to 
the SDA command: 


$ SUA COUMFSAIBADUCK 


Defining SDA as a foreign command abbreviates SDA initialization 
because it eliminates the need to respond to the dump file prompt. 
For further information on the foreign command feature of DCL, see 
Appendix A of the VAX/VMS Command Language User's Guide. 


You can also invoke SDA from the site-specific start-up procedure; 
Section 3.6 describes this method of calling SDA. 


3.3 EXAMINING THE RUNNING SYSTEM 


Occasionally, VAX/VMS encounters an internal problem that hinders 
system performance without generating a system failure. By allowing 
you to examine the running system, SDA provides the means  to_- search 
memory for the solution to the problem without disturbing’ the 
operating system. 


To examine the running system, invoke SDA as described in Section 3.1. 
SDA automatically sets the process context to your process. (See the 
description of the SET PROCESS command in Chapter 5 for a discussion 
of process context.) 


To analyze the system dump file, SDA maps the entire file. By 
contrast, when SDA examines a running system, it retrieves only the 
information necessary to process a given command. 


Because of the system's dynamic nature, use extreme caution when 
examining the running system. Although you can safely reference most 
locations, accessing certain portions of memory, such as I/O address 
Space or nonresident process header pages that the current process 
does not own, causes the system to fail. 


3.4 READING THE SYSTEM DUMP FILE 


When you invoke SDA and specify the name of a dump file (or. press 
RET) ) SDA gathers’ the data needed to create the displays from that 
dump file. Under certain conditions, the contents of general purpose 
or processor registers may not be saved in SYSDUMP.DMP. 


RUNNING SDA 


For example, during console restart -bugchecks, such as HALT, the 
VAX-11 LSI-11 console program destroys the contents of all the general 
purpose registers except the program counter and the processor status 
longword. SDA indicates in the SHOW CRASH display that the registers 
were wiped out by the console. 


Processor registers may also be lost if the error log buffers in 
memory are full. When the operating system writes data _ to 
SYSDUMP.DMP, it creates an error log entry in the error log buffer 
that stores the contents of the processor registers. If the buffers 
are full, the contents of the registers are lost because the operating 
system cannot create an error log entry for them. Again, SDA prints a 
message in the SHOW CRASH display indicating that an error log. entry 
for the registers does not exist. 


Although the system dump file must be contiguous for the operating 
system to write information to it successfully, the file need not be 
contiguous for SDA to read it. Thus, if your copy of the system dump 
file is not contiguous, you will still be able to run SDA. 


3.5 BUILDING THE SDA SYMBOL TABLE 


After locating and reading the system dump file, SDA next attempts’ to 
read the system symbol table file. This file, named SYS.STB, contains 
all the global symbols used by the operating system. SDA'sS ability to 
read global symbols makes it easier to analyze a dump because you can 
examine locations by symbol rather than by virtual address. 


SDA first looks for SYS.STB in the directory and device containing the 
system dump. If the file is not there, SDA looks for it in the system 
directory SYSSSYSTEM. Once SDA finds SYS.STB, it copies the file's 
contents to the SDA symbol table. If SDA cannot find the system 
symbol table file, it will not run. 


When SDA finishes building its symbol table, it prints out a message 
identifying itself and the immediate cause of the crash: 


VAX/YUMNS System cume anmadweer 

Thine taken om 2Be-rebe L979 O1722358.43 

MTXCNTNONZ» Mutex count momzero ab system service exit 
STA Ls 


The SDA> prompt indicates that the utility is ready to accept SDA 
commands. You can now use SDA interactively, send selected 
information to a file, or print selected information on a _ line 
printer. Refer to the description of the SET OUTPUT command in 
Chapter 5 for directions on setting up output files. 


3.6 INVOKING SDA IN THE SITE-SPECIFIC START-UP PROCEDURE 


Because an SDA listing is an important tool in determining the general 
nature of a system failure, it is a good idea to make sure that one is 
produced after every crash. The system manager can ensure the 
creation of an SDA listing by modifying the SYSTARTUP.COM file in 
[SYSMGR] to invoke SDA when the system is booted. 


RUNNING SDA 


When called by the start-up procedure, SDA scans the system dump file 
for a flag that indicates whether SDA has processed the file. This 
flag is cleared each time the operating system writes to SYSDUMP.DMP, 
except in the case of an emergency shutdown (OPCCRASH.EXE). If the 
flag is clear, SDA executes the commands designated in the command 
procedure and sets the flag. If, however, SDA finds that the dump 
file flag is set, it exits without performing any of the specified 
commands. Thus, SDA will execute only if the system just failed. 


To allow you to run SDA from the site-specific start-up procedure, the 
system parameter POL DPGFLQUOTA must equal the size of the system dump 
file plus 1000 pages. See the VAX/VMS System Manager's Guide for more 
information on system parameters. ©}. 


The example below shows commands that might be added to the 


site-specific start-up procedure to produce an SDA listing after each 
crash. 


$1 
S$! Print dump listing if system just failed 
$ ! 
$ RUN SYSSSYSTEM:SDA 
SYSSSYSTEM: SYSDUMP.DMP 
COPY SYSSSYSTEM:SAVEDUMP.DMP 
SET OUTPUT LPAO:SYSDUMP.LIS 


Save dump file 
Create listing file 


SHOW CRASH Display crash 
information 
SHOW STACK Show current stack 


SHOW SUMMARY List all active 
processes 

Display current process 
Print system symbol 


table 


SHOW PROCESS/PCB/PHD/REG 
SHOW SYMBOL/ALL 


EXIT 


CHAPTER 4 


SDA COMMAND STRINGS 


The following sections describe the SDA command format and the types 
of expressions SDA uses within commands. 


4.1 GENERAL FORMAT 


SDA uses a command string format similar to that of the DIGITAL 
Command Language (DCL) interpreter. You issue commands in the general 
format: 


command [parameter] [/qualifier] [!comment] 


command 


The name of an SDA command that tells the utility to perform a 
certain function. Commands can consist of one or more words, and 
can be abbreviated to the number of characters that make the 
command unique. For example, SH stands for SHOW and SE stands 
for SET. 


parameter 


The target of the command. For example, SHOW PROCESS GORK tells 
SDA to display the process GORK. 


When a parameter is a file specification, the current default 
device and directory are represented as listed below. 


Default Meaning 


SYSSDISK Device specified in the most’ recent 
SET DEFAULT command 


[default-dir] Directory specified in the most 
recent SET DEFAULT command 


See the VAX/VMS Command Language User's Guide for a description 
of the DCL command SET DEFAULT. 


/qualifier 


The name of a command qualifier that modifies the action of an 
SDA command. A qualifier is always preceded by a slash (/). 
Multiple qualifiers can follow a single parameter but must _ be 
delimited by slashes. Qualifiers can be abbreviated as long as 
they remain unique, 


SDA COMMAND STRINGS 


'comment 


A comment. SDA ignores the exclamation point and all characters 
appearing after it on the same line. 


4.2 EXPRESSIONS 


Certain SDA commands allow expressions aS command parameters. To 
create expressions, you can use: 


e Radix operators 

e Unary operators 

e Binary operators 
e Special operators 


e Symbols 


4.2.1 Radix Operators 


Radix operators determine which base SDA uses to evaluate expressions. 
You can use one of three radix operators to specify the radix for a 
numeric value. 


Operator Radix Example 
“xX Hexadecimal *X10 
“Oo Octal “030 
“D Decimal “D16 
The default radix is hexadecimal. SDA displays hexadecimal values 


with leading zeros and decimal values with leading spaces. 


4.2.2 Unary Operators 


SDA recognizes the following unary operators: 


Operator Function 
+ Assigns positive value 
= Assigns negative value 
@ Uses contents of location 
G Adds 80000000 to value 
H Adds 7FFE0000 to value 


The unary operator G corresponds the first virtual address in system 
space, while the unary operator H corresponds to a convenient base 
address ina process's control region. 


SDA COMMAND STRINGS 


4.2.3 Binary Operators 


SDA performs integer arithmetic on 32-bit operands. The characters 
indicating arithmetic operations are: 


Operator Function 


Addition 
Subtraction 
Multiplication 
Division 
Arithmetic shift 


@Mn * 1 + 


SDA carries out multiplication, division, and arithmetic shift before 
addition and subtraction. In division, SDA does not round integers, 
nor does it retain a remainder. 


4.2.4 Special Operators 
SDA usesS parentheses aS special operators. Expressions enclosed in 


parentheses are evaluated first. In the case of nested parenthetical 
expressions, SDA evaluates from innermost to outermost. 


4.2.5 Symbols 


Symbols are composed of 1 to 31 alphanumeric characters that can 
include the special characters dollar sign (S$) and underline(_). 


SDA copies symbols into its symbol table from the SYS.STB file. They 
can also be created by the DEFINE and READ commands. 


In addition, SDA provides the following special symbols: 


Symbol Meaning 

: Current location 

G 80000000 

H 7FFE0000 

RO-R11 General purpose registers 

AP Argument Pointer 

FP Frame Pointer 

KSP Kernel Mode Stack Pointer 

ESP Executive Mode Stack Pointer 
SSP Supervisor Mode Stack Pointer 
USP User Mode Stack Pointer 

POBR Program Region Base Register 
POLR Program Region Length Register 
P1BR Control Region BaSe Register 
P1LR Control Region Length Register 
PC Program Counter 

PSL Processor status longword 


The register symbols correspond to the registers saved in the hardware 
context of the current process (see the description of the SET PROCESS 
command in Chapter 5). For example, 


SOA EXAMINE @USF 


This command displays the first longword on the user mode stack. 


their 


CHAPTER 5 


SDA COMMANDS 


Table 5-1 lists the SDA commands and gives a brief explanation of 


COPY 
DEFINE 
EVALUATE 
EXAMINE 
EXIT 
FORMAT 
HELP 
READ 


REPEAT 


SET OUTPUT 
SET PROCESS 


SHOW CRASH 
SHOW DEVICE 
SHOW PAGE TABLE 
SHOW PFN DATA 
SHOW POOL 


meng A cee ol 


SHOW PROCESS 


SHOW STACK 


SHOW SUMMARY 


SHOW SYMBOL 





functions. 
abbreviations. 





underlined characters represent command 


Table 5-l 


Summary of SDA Commands 


annem 


Function 





a he helt 





mae 


Copies the dump file 





Deahandymtiestngh hye at', cyamandine . angsone HQT” fo ARERR A Ra Gm or mm Me OMG YN Rr me 


Defines symbols and their values 
Performs computations 

Examines memory locations 

Exits from the display or from SDA 
Formats data blocks 

Prints help files 

Copies object module symbols 


Repeats the last command 





Sets output to the device or file 
specification 


Sets the process context to ae specific 
process 


Displays crash information 

Displays I/O data structures 

Displays the system page table 
Displays the PFN data base 

Displays dynamic memory 

Displays specific process information 
Displays process/interrupt stacks 
Displays a summary of all processes 


Displays the symbol table 


Sea | 


SDA COMMANDS 


COPY 


Each time the system fails, new information is written over the 
contents of SYSDUMP.DMP. The COPY command allows you to preserve the 
contents of SYSDUMP.DMP by copying it to another file. (The resulting 
copy does not have to be a contiguous file; see Section 3.4.) 


In most cases, the system manager will include the COPY command in the 
SYSTARTUP.COM command procedure so that each time the system fails, 
SDA will copy the system dump file to another file. 

Format 


COPY output-file-spec 


Qualifiers Defaults 
None None 
Parameters 


output-file-spec 


The device, directory, and file name to which SDA copies’ the 
system dump file. The default file specification is 
SYSSDISK: [default-dir]SYSDUMP.DMP. See the  VAX/VMS Command 
Language User's Guide for more information about file 


alanis: =n ape atmgaR LLNS pes 


specifications. 
Examples 
Ls SDA> COPY SYS$SYSTEM: SAVEDUMF 
The COPY command takes the SYSDUMP.DMP file and copies it to the 


system device and directory SYSSSYSTEM under the file name 
SAVEDUMP.DMP. 


SDA COMMANDS 


DEFINE 


The DEFINE command assigns a value to a_ symbol. SDA evaluates’' the 
expression before assigning it to the symbol. If the symbol is 
already defined, the new value simply replaces the old one. 


Although both DEFINE and EVALUATE perform computations, DEFINE adds 
symbols used for temporary computations to the SDA symbol table, while 
EVALUATE simply performs the computation. 


Format 
DEFINE symbol ! i | expression 
(GP) 
Qualifiers Defaults 
None None 
Parameters 
symbol 
A l- to 3l-alphanumeric character symbol you designate to 


represent a value. See Section 4.2.5 for a discussion of valid 
SDA symbols. 


expression 


An expression to be defined by the symbol. You can separate the 
expression from the symbol by a space or by an equal sign. See 
Section 4.2 for a discussion of SDA expressions. 


Examples 


1. StAQ> DEFINE BEGIN = 80058E00 
SHA» DEFINE END = S0058E460 
SQA’ EXAMINE BEGINSEND 


In this example, DEFINE delimits a range of address space. A 
subsequent EXAMINE command can then easily examine that section 
of memory locations. The symbols serve as reference points in 


memory. 
2s STAs THER INE NEXT = @FC 
STAs EXAMINE NEXT 
OO000434 3 LEDARS 12 aa © 


The temporary symbol NEXT defines the address contained in the 
program counter. SDA represents nonprinting characters by a 
period (.) and puts quotation marks around ASCII text. Refer to 
Section 4.2.5 for a discussion of SDA symbols. 


3. STAs TEFINE VEC SCHéGL.PCRVEC 
A symbol VEC has been assigned to a global symbol. Now you can 


access the memory location or value represented by the global 
symbol by specifying the symbol VEC. 


SDA COMMANDS 


Soa? VEFINE COUNT = 4 

Sta? TERFINE RESULT = COUNTXCOUNT 
Syria EVALUATE RESULT 

Hex = QO0O0O00010 Yecimal = 14 


The value 4 is symbolically defined and_ then 
arithmetic expression. 


used 


in 


an 


SDA COMMANDS 


EVALUATE 


The EVALUATE command computes the value of any SDA expression = and 
displays the results in hexadecimal and decimal format. 


Format 


EVALUATE expression 


Qualifiers Defaults 
None None 
Parameters 
expression 
The expression to be evaluated. See Section 4.2 for a 


description of valid SDA expressions. 


Examples 


i 


STAs EVALUATE «1. 
Hex = FREEEERF Yecama dl = 1 


EVALUATE prints the values of negative 1 in hexadecimal and 
decimal. 


SQA* TEFINE TEN = A 
STAs EVALUATE TEN 
Hex = QOO00004 Necimael = 10 


EVALUATE computes and displays the value of the symbol TEN. In 
this example, the character "A" could also be a symbol. When SDA 
encounters a quantity that can either be a symbol or a 
hexadecimal expression, SDA first treats the quantity as a symbol 
and looks for it in the symbol table. If SDA cannot locate the 
quantity in the symbol table, it evaluates the quantity as a 
hexadecimal expression. 


SQIA> EVALUATE ¢(CTENK6)+0-174))>4+(024+4) 
Hex = 00000042 Yecimal = 64 


The EVALUATE command evaluates a complex expression and prints 
the result as hexadecimal and decimal values. See Sections 4.2.2 
through 4.2.5 for a discussion of the expressions used in this 
example. 


SDA COMMANDS 


EXAMINE 


The EXAMINE command displays the contents of a location or range of 
locations in physical memory. 


You can use location parameters to examine specific locations or _ you 
can use qualifiers to display entire process and system regions. 
There are two ways to examine a range of locations: 1) designate 
Starting and ending locations separated by a colon, for example, 
80000040:80000200; or 2) specify a location and a byte length, 
separated by a semicolon, for example, 80000400;16. 


If at any time you omit the location parameter from the EXAMINE 
command, SDA takes the location you last examined, increases it by 4 
(one longword) and examines the resulting location. 


Examining Specific Locations 


A location can be represented by any valid SDA expression. When you 
use the EXAMINE command to look at a location, SDA displays the 
location, its symbolic representation (if possible), and its contents, 
in hexadecimal and ASCII formats. 


SDA initially sets the current location to -4 (decimal) in the program 
region (PO) of the process. To examine memory locations in other 
processes, you must use the SET PROCESS command. 


Examining Memory Regions 


You can dump an entire region of virtual memory by adding one or more 
qualifiers to the EXAMINE command. 


SDA formats the dump into columns of longwords, 4 for an 80-column 
device and 8 for a 132-column device, and prints the ASCII value of 
the longwords on the right side of the display. The final column 
contains the address of the first longword in each line. You read the 
dump display from right to left. 


If a series of virtual addresses does not exist in physical memory, 
SDA prints a message specifying the range of addresses that were not 
translated: 


Virtual locations locl : loc2 are not in ehusical memory 
In this message, locl and loc2 represent the starting and ending 
addresses of the _ range. This message also appears if you try to 
examine a single location that has not been mapped into physical 
memory. 


If a range of virtual locations contains only zeros, SDA prints’ the 
message: 


Zeros surrressed from lLlocl to loc2 


SDA COMMANDS 


Format 


[location] [: location] 
[; length] 


EXAMINE 
Qualifiers Defaults 
/PO None 
/Pl 
/SYSTEM 
/ALL 

Parameters 


location 


Expression that specifies the address in virtual memory at which 
data is stored. 


length 
Expression that specifies the number of bytes you want to 
display. 

Qualifiers 

/PO 
Prints the entire program region for a given process. The 
default for this qualifier is the PO region of the current 
process; you must use the SET PROCESS command to examine other 
processes' POQ regions. 

/Pl 
Prints the entire control region for a given process. The 
defauit for this qualifier is the Pl region of the current 
process; use the SET PROCESS command to examine different Pl 
regions. 

/SYSTEM 
Prints portions of the writeable system region. 

/ALL 
Prints both the entire program and control regions for a given 
process, and portions of the writeable system region. 

Examples 


1. SlA> EXAMINE 80000200 
SYS$SETEF ¢ S8FBCOOSC a 


The system virtual address is defined by a global symbol. The 
information stored at this address is given in hexadecimal and in 
ASCII formats. SDA represents nonprinting characters by a period 
(.) and puts quotation marks (" ") around ASCII text. 


SDA COMMANDS 


SoA> EXAMINE FC 

FC ¢ 80Q008E22 sae a ie 

SOAS EXAMINE @FC 

EXESRUNDWN+tO038 $$ 61772065 "e@ wa" 


SDA examines the program counter and the address contained in the 
program counter. 


SA EXAMINE 80000008311 


SDA displays a range of bytes starting at address 80000008 and 
ending at 80000027. SDA displays byte ranges in units of 16 
(decimal) bytes. In this case, SDA displays two lines of 16 
bytes even though a value of 17 (11 hexadecimal) was given. 


SUAS EXAMINE/SYSTEM 


Figure 5-1 showsS a portion of the display produced by this 
command. 


VAX/VMS 2,8 ~-= Sygtem Dump 
System region memory 


area2araca 
BASE BEA 
41424473 
SAAZIIAB 
Baase Rea 
BABl7E REC 
AAAC6E17 
8agerSc3 
Bagreade 
BAgUE ACA 
GISAGFES 
BABR39Ah8 
Baarrscar 
BaRmers6e 
ARAVEUSR 
Avrevrearca 
BABCYE RKO 
EF {O3FER 
RAACI SEE 
BaBecgo7c 
41584473 
BPACIIAB 
Baaersea 
BPACEAFC 
AABEY AGB 
@aeurcava 
AAWVYPILES 
ESESESES 
ESESESES 
ESESESES 
FSESESES 
Zaanen¢a 
BagerCic 
BAaACeEFC 
BaareCSc 
BAALY ALA 
AGaare see? 
BeereOeRd 
Bag7?eder 
aaBreerec 
FREAPFFFF 
aiggagaa 
Agelrile? 
S8ag@eedac 
“aaCuEra 
BAALE ZAR 
aeeovcara 
AABSeael 
BABVBE ALA 
BABKE3RCA 
BABB Gee 
BageeEer 
8AA2¢CE9B 
gaagereanee 
BAShRAREe 


CAAARBAAS 
BAPACB4B 
62313146 
PYRAADAAAG 
AAALAAYL 
PZOF1IZ16 
POPUODES 
HACC ARAG 
PAARAVEELA 
ABANAAPRA 
AABAGPRE 
AAP AAPAA 
AAYILTZAAAL 
VBAAKAA® 
CAG u49aT? 
eavaeaeu 
FPASARPARA 
AAZARABRA 
RAPVIT1E 
AARP AVACA 
“3313146 
AMM ALP AAA 
PAARAKCA 
eeadeyyA 
FAARAAL 
CRAPVARY 
BAVPZRSU 
ESESESES 
FSESFSES 
ESESESES 
FSESESFS 
a1iaPpugnes 
CAGAFI 34 
AAP LAAAL 
UAVAZALA 
PEAAC AGA 
BBLUsaTa 
ACA WAAL D 
ZAAYRAAY 
YARARALA 
AGKVARBIG 
yvCisvacri 
CAR ARAAR 
BAAARE2SA 
UBRAACZVE 
Par ARARe 
PAC AARAR 
RARLAKAAG 
AnAanaga 
ABAAAABR 
BarAVAAA 
BAAAGEFC 
BAPARESS 
arnAgaave 
FABAPALA 


CEAAGAAF 
PAaBYVARAA 
Brgeasads 
Auagraase 
YaAAngAAA 
M2AaAAesAt 
AAABIL ALTA 
BYQAABRBC 
AvaveaeAA 
yaaceaeas 
BYAPSIBA 
eyveaarse 
YAIPARAAD 
APRU2RH? 
PRAVUBOLA 
Baea2dag 
veeearel 
APPR RP ARAL 
By aareds 
azegaric 
Aaayveausn 
AYPAAACS? 
FFE Magar 
AZATABAL 
AYP4ULBL? 
BAP Ue AAP 
Braagkoeu 
ESESESES 
FSESESES 
ESESESES 
ESESESES 
AP AAAGAA 
AAPUARBY 
PARPAP FEF 
ALAAGAAA 
ACAaLTaate 
8YanaC>9e 
BaueeebEa 
Baaeacoa 
AARARGAL 
PAAnBaAAU 
AABBAUAA 
Ysabaege 
VQPAP AAP 
AvagveaRaAA 
A8iseerva 
ReaevarAA 
AAAABBBAA 
AaPuReAA 
S4454EQ3 
agaraecs 
ABSLAAAL 
agaaaaar 
2auevugena 
Aneneraa 


Amalysis 


aganageas 
TFFEEAFU 
AQAA 34 
45564950 
8Ae17BaA 
i1Cadaeags 
AAABARAA 
FCACARGA 
eAeAALae 
eeanarae 
AS? HAE 34 
yFS54445e2 
ASABPPILS 
aCeaueca7 
AAPAPE AD 
PACAAP IE 
AAUAAP AE 
ePAesagad 
ZAAGCBEAP 
VaaRapaa 
FAME SY 
45564952 
Revaeceln 
1Cad4ere 
ACPAARBAD 
APAACEL?ES 
AAAPALRAE 
ESESESES 
FSESFSES 
FSESESES 
ESESFSES 
Baaaye7c 
auryag5se 
oagareia 
ABLSAPAY 
AR PAAR AG 
RagGBAC IG 
RAGAAEFC 
RaeaerDde 
AR AAAEFA 
YAPAABAB 
RePeserSS 
Ree7?742e 
avCeacee 
AAP RACP?A 
AZeeACAA 
BAARPDTB 
BaaaavdeEc 
ABEZAKBPSe 
AASHUSUE 
VAABBEEA 
PeZAGAGA 
gerArgeaa 
AAAAARLA 
AAP AgEBA 


AAAAAALZ 
PFABAAGAB 
84gaeas7C 
4uarpduae 
8°R17CAae 
A2A2629A0 
asi5aaza 
PAszeaARAB 
AAAAgBAA 
C2ABARAAS 
BABAADIC 
USSA4Fag 
aagearaan 
AAaRnaARaAAg 
AALagaae 
PARACAAP 
AGAGEFFEF 
AC AAGAAA 
PRAPEGanE 
AP AAAAAP 
BUAAAABC 
4ussauas 
AAAPBAAR 
BPAHECAD 
azsiaaane 
PAAAPRAB 
PE BFAAA 
ESESESES 
FSESFSES 
FSESESES 
ESESESES 
AAAGAASY 
45564952 
Grarvaac 
VPAPARAP 
PAAB AAR 
AUAZARAA 
QAA1AAA4 
BVBPABAA 
APAG ABBA 
?BYaaa7u 
azareaaar 
PPBABALV? 
aranaaga 
41aCdEas 
CARAAABA 
BAGAAEFC 
BaBAaadEc 
aagraaad 
82001648 
eaaeaseus 
e@RARnAAARe 
aciCeaag 
BZAAABAAA 
ABAABAAA 


Figure 


GAPCAAADA 
FAAAAALL 
BaaaaguB 
AAP BAAAD 
80%62866 
RACHRBEB? 
B8ae7aese 
ASASAAAD 
QAEERQEGAA 
Zaaaaagne 
BABBBABS 
AAR AAGAA 
BAAAae4eo 
AACBRAAA 
Bar7TAaza 
vaeseagal 
VAP27BBA 
JAAACAAA 
8a2916CA 
RAABAASC 
RACBABES 
AALAAAAB 
BRAAQAAT 
pauaeraa 
RAV TBB22 
aaraneac 
PAVIAACF 
ESESESES 
FSFSESES 
ESFSESES 
ESFSFSES 
Baaarcga 
4adgpudas 
AABPAAAD 
Banaelcoa 
VAARZAAAR 
NADAGCAGA 
FF OFFFFF 
SLAAGBAA 
Aa@Alaiia 
Baraadas 
RAABABES 
Barges 
araaeaga 
ABAAARAB 
AAVAABAA 
ABALIPQAL 
PABAFABD 
AAAACAAG 
22660034 
56u9Sea4g 
ASCACBAG 
8a76aC3a 
yargagal 
AAABABAD 


a 


A2AaazdseB 
aaaagaee 
8ag2inde 
garagaca 
@a8iaaecc 
eagAagage 
areraaeac 
8P1L14A2C 
1eeaaaae 
BAvrsgaaar 
SGBQRGAR4 
PAagBAaeaaA 
e@e1aagac 
AAARAAARE 
Bagaarae 
BaaeBbela 
AAATH7A? 
BRGAaRPAD 
Baaaeaeld 
GAAAeces 
BaganaBC 
Aanagneae 
YB1LG412S 
Paaaaaaa 
a2eaaeal 
Beaadats 
Zar agaage 
ESESESES 
ESESESES 
ESESESES 
ESESESES 
87 aeeD78 
AAAABABA 
BA19Re74 
Paar aBee 
AAAAAKR BSG 
CAAAP AAA 
anaageats 
acisSaeel 
anaaggaa 
Beaceades 
BABABEFC 
Baresnuu 
Aagaausa 
8A201608 
agaaagse 
APAARAGA 
anedagaa 
aaanaaia 
B8e2anBeESS 
S4uS4Ee9 
Qaazgaada 
GPBAAAAP 
@agnegga 
AACABeCBA 


System 


Aaae2e7393 
AGGAgAaLA 
8ae69ea92 
AAP SABA 
BaAgas9as 
BA? FAB4S 
8BAGAZBBC 
aveaeaco 
AAaS32BE 
22A0a9a8 
ZACAAABG 
AO RAAAG? 
BeeAS9GAB 
AgAREI4SB 
aeegagBle 
ARPAARAAD 
BA BEF 164 
AZa@8420 
angeaacaB 
EF {6 3FB5 
8ge@earaBe 
AAABALAS 
BAAAZIAB 
RAABAABB 
Se@azzZAaFC 
aggarecc 
APFARIEE 
PARBAPAAA 
ESESESES 
ESESESES 
FSESESES 
ESESESES 
BAAAAARAA 
Bageucic 
A2u0ABEY 
Reaaecse 
PAABASAG 
AAPABAA|A 
AAAARBSA 
eaabeage 
ASASBACAA 
Pe21Aaaesd 
AEAAGAAA 
azgaaeagea 
ACG6OAS4 
455649582 
ABAABAAA 
aCiSeaal 
AAPAAABA 
8A4E3 268 
BACAABBA 
28190088 
AFARABAA 
200008008 
AACAALBAB 
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8eagesea 
83Ae882a 
Baeeghse 
8ge0a86o 
8aeae88ea 
8GCAGRBAG 
8aaeesce 
8AGQG8ES 
s8agca9aa 
8aneasea 
88280949 
890889690 
8aga098B 
BOARAIAR 
8aa2a9ce 
BA2aan9EQ 
8BAGQAGB 
89eagA20 
BARAGAGD 
B9GA8AbD 
8agagase 
Baaae@aag 
8O8@aaCga 
BABAGKEQ 
aageabaa 
8A820B2e 
8g06a64ea 
Beacakea 
80088882 
B8AC2GBAR 
&8eaaBCa 
B8a@cegBEa 
8aeeeCana 
8ageace2o 
8eeee8C4s 
BaesdeCes 
a8ga2cecBea 
8aaeaaCag 
8aaaeCCa 
Saaaacea 
S8agoaDea 
S8agaadeg 
B8geqaD4—9 
8gaaedse 
8a000082 
BaseaDag 
8ageaa0Ce 
&8geaaadeg 
S8aeaeEae 
8aaeoE2a 
8aa0eE4e 
8aegaaE6a 
8agasese 
8aegagEAg 
BAGeRECA 
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SDA COMMANDS 


EXIT 


The EXIT command performs two functions: it discontinues SDA displays 
and exits from the utility. During interactive sessions, if a display 
has more than one page and is being shown on a video display terminal 
such as a VT100, SDA will issue the following message each time it 
reaches the bottom of a page: 


Prass RETURN Por more. 
STi 


If you want to discontinue the current display, type EXIT at the 
prompt. (On hard copy terminals, SDA does not prompt at the bottom of 
each page.) If you do not type EXIT at the screen overflow prompt and 
simply execute another command, SDA will accept the command as if you 
had exited from the display. 
To stop SDA, type EXIT in response to the SDA prompt. 
Format 

EXIT 

Qualifiers Defaults 

None None 


Parameters 


None 


5-10 


SDA COMMANDS 


FORMAT 


The FORMAT command displays a formatted list of the contents of a 
specific block. It attempts to: 


e Characterize a range of locations as a block 
e Assign a symbol to each item of data within the block 


Most VAX/VMS blocks contain a byte that indicates the block type. 
This byte is stored at offset 10 (decimal) from the first address of 
the block. The FORMAT command examines the byte stored at this offset 
as a block type. If the byte represents a valid block type, SDA tries 
to find its corresponding symbols. If the byte does not represent a 
valid block type, SDA issues the message; 


imvelid block tyre in seecified olock. 
Not every block contains a block type byte at offset 10. If this byte 
is absent, you must designate a block type at command level by using 
the qualifier /TYPE in order to format the block. 
The display produced by FORMAT shows, from left to right, the virtual 
address of each item within the block, its symbolic name, and its 
hexadecimal representation. 


Format 


FORMAT location 


Qualifiers Defaults 
/TYPE= None 
Parameters 
location 
The starting location of the block you want to _ format. The 


location can be any valid SDA expression. 


Qualifiers 
/TYPE=block-type 


The symbolic prefix that corresponds to the type of block 


structure you want to format. SDA finds all symbols containing 
the specified prefix in the form: 


block-typeSfield-type field-name 
The field types accepted by SDA are: 


longword 

word 

byte 

quadword 

counted ASCII string (0 through 31 characters) 
constant 


QHdovar 


SDA COMMANDS 


You can define your own block types and use the READ command to 
include them in the SDA symbol table. Thus, a valid block type 
is one that SDA can find in the symbol table. If SDA cannot find 
the symbols associated with the block type you have indicated, it 
will issue the message: 


No "block-type" symbols found to format this block 


Examples 


1. 


SUA? FORMAT @SCHIGL CURFPCE 


80069550 RPORBL OOF L. BOOORF 4A 
BOObFIS4 PCBRELSQ8L. BOODLE 4 
80069558 PCRSWOSTZE 0070 
BO069 SSA POR SER.. TYRE OC) 


+ 
¢ 


+ 


SDA takes the address pointed to by the global symbol, obtains 
the block type, and formats the block. 


$ RUN SYSSSYSTEMS SUA 


+ 


SUAS REAN GLOBALS.STR 


SUAS FORMAT @LOCS&GLTIEVL IST 


BOO0084E8 QE ELL NK 80000948 
BOQQ08 40 QO LUC BOO008 70 
BOOOQOBIO INBSWOS TLE 0034 
BQOOQ0OBS2 NOB bE TYRE: OG 
BOQ008SS 00 
8SOQO08 G4 NOB BL OT SOOSO408 
SOOOOB GS DUS $L..ACKT OL SLSLASG 
80000850 OTE T.NAME. "TRA © 
BOOQN8SO 00000000 
BOQ00864 00000000 
80000868 00000000 
BO0008 SC DS TCR YNAME: "QEROR LT VER * 


SUA> FORMAT @, 


+ 


SAS REFEAT 


This example illustrates the use of SDA commands to format a list 
of blocks. The steps followed in the example are listed below: 


e Invoke SDA. 


e Use the READ command to read the DDB symbol definitions 
from GLOBALS.STB into the SDA symbol table. For a 
further discussion of object module files, see _ the 
description of the READ command. 


e Use the FORMAT command to format the location pointed _ to 
by the global symbol IOCSGL DEVLIST. When SDA finishes 
formatting this block, it sets the current location to 
the first byte of the block. 


a= 12 


SDA COMMANDS 


Use the FORMAT command again to format the next block in 
the device list. Most blocks contain a pointer to the 
next block in a linked list. This pointer is usually the 
first longword in the block. In this step, the FORMAT 
command causes SDA to format the contents of the current 
location (the first longword of the block). 


Repeat the FORMAT command to format the next entry in the 
list. In this way, you can step through the entire 
device list, formatting each block. 


SOAs READ SYMDEF 
SOA? FORMAT GIOACOO/TYPE=FHII 


BOLOACOO 
8SOLOACO4 
BOLOACO8 
BOLOACOA 
BOLOACOC 
SOLOACOE 
BOLOACTO 
BOLOAC TL 
BOLOAC TL 4 
BOLOACIES 
BOLOAC LA 
BO LOAC TO 
") 


free 


BO LOAL LO 
BO TOAC 2 Ae 
SO LOA LF 
BOLOAC LS 
BO LOA LS 
BSOLOAC LE 
BO LOAC SO 
SOLOAT SA 
BO LOAT SE 
SOLOACSY 
SOLOAC ATL 
BOTLOAC ST 
SOLOAC AO 
BSOLOACaL 
BOLOALA4 
BOLOALAS 
BOTLOACaS 
SOLOAC4aA 


BSOLOACAC 
BOLOACTO 
BOLOACIA 
BOLOACSS 


This exa 
command 


the description of 


syntax). 


PHOS QR ITUMSK OO SO8N08 
00000000 
OO4S 
0420 
OOS 
OOS T 
OOS 
OOUR 
QO9O00000 
O42 TI 
OOTIE 
OSOQOOO0 


PROB. 
rts W 
HTS W.. 
MIS W... 
PIB W... 
HTB W... 
tO ee 
hOB W... 
MhB W.. 
Beh... 
FOB ER. 
PEW... 
a 


WSLIST 


WSLOCK 
WSOYN 
WONE XT 
WSLAST - 
REPRE RL T 
WSQUOTA 
QE WSONT 
PAGE TL. 
RAGE Tl. 
P'S | 
FoSTRASOFF 


0600 


OOOO 
BR ES 
0000 
QOD AAR OO 
OO001978 
AEE UP OOO 
OO2 ZOBLT 
tau 
O32 
00086 
QOOOR RA? I. 
pe fe oo Zo 
0008 
0010 
QOOOF 


PHI W.. 
PHY W.. 
EHI6 1 
EYL. 
MIB I... 
PMIMBL... 
PHBE. 
EHYIB R.. 
PHI W.. 
EP MIXIB La 
HIB W... 
FYI W... 
EP HXIb WW... 
HIN W... 
HIN W... 
HIB Wh... 
hab W 
PHU6LPAGEFL TS 
PHIIBL..u2ILOGNT 

PHIL... RLOCNT 

PHL OE UL IM 


o 


FSTLAST 
PSTFPREE 
FREFOVA 
PREP TECNT 
FREE AVA 
POFLONT 
EPEC 
POTRFEC 
FLAGS 
CRUTIM 
QUANT 
PROLM 
ASTIM 
PHY INDEX 
RAK 

WSL.X 


900 


00064510 
Q0005 631 
QQOOOFO 2G 
00000000 


+ 


+ 


mple shows the use of the qualifier /TYPE=. The READ 
is issued to move PHD symbols to SDA's symbol table (see 
the READ command for details on command 


Then, the FORMAT command can identify the process 


header block that starts at location 80l10ACO0. 


SDA COMMANDS 


HELP 


The HELP command lists information about the SDA utility, its 
operation, and its command format. HELP has three command parameters. 
If you do not specify a parameter, HELP gives a brief description of 
SDA operations and lists SDA commands. 


Format 


fcommand-name ] 
HELP ( [EXPRESSION ] 


[OPERATION ] 
Qualifiers Defaults 
None None 


Parameters 
command-name 
Specifies the SDA command for which you need information. 
EXPRESSION 
Prints a description of SDA expressions. 
OPERATION 


Describes how to operate SDA at your terminal and through the 
Site-specific start-up procedure. 


SDA COMMANDS 


READ 


The READ command lets you extract global symbols from any object 
module file and insert the definitions automatically into SDA's symbol 
table. 


The object module file can be the output of a compiler or assembler or 
the output of the linker qualifier /SYMBOL TABLE. 


It is important to note that the READ command recognizes global 
symbols but ignores local symbols; hence, only global symbols are 
copied into the SDA symbol table. 


The program below shows some sample definitions of global symbols. 


-TITLE GLOBALS, GLOBAL SYMBOLS FOR SYSTEM DUMP ANALYZER 


Note: the macros in this program must use the 
argument GLOBAL. This argument defines them as 
globals so that they will be automatically carried 
into the object file. Without the GLOBAL argument, 
the macros would be local and SDA would not be 

able to read them. 


me *e ese Ne Be We We WE 


SPHDDEF GLOBAL > PROCESS HEADER DEFINITIONS 
SDDBDEF GLOBAL DEVICE DATA BLOCK 

SUCBDEF GLOBAL UNIT CONTROL BLOCK 

SVCBDEF GLOBAL VOLUME CONTROL BLOCK 
SACBDEF GLOBAL AST CONTROL BLOCK 

SIRPDEF GLOBAL I/O REQUEST PACKET 


=e §e %s 6 6FOlUGOUT 


: (more macros can be inserted here) 
« END 
Use the following DCL command to generate an object module file with 
the file type STB that contains the global symbols defined in the 
Sample program GLOBALS.MAR, as shown above: 
$ MACRO GLOBALS+SYS$LIBRARYtLIB/LIBRARY /OBJECT=GLCOBAIS.STRB 


Now you can invoke SDA and use the READ command to copy the symbols 
into the SDA symbol table, aS Shown in Example 1 below. 


Format 


READ file-spec 


Qualifiers Defaults 
None None 
Parameters 


file-spec 


The device, directory, and file name of the file whose symbols 
you want copied to SDA. The default file specification for this 
parameter is SYSSDISK: [default-dir] filename.STB. 


SDA COMMANDS 


Examples 
li SoA: READQ GLOBALS 


SDA searches for the file specification GLOBALS.STB in the 
current device and directory. 


SDA COMMANDS 


REPEAT 


The REPEAT command repeats execution of tne last command issued. This 
command is primarily used to step through a linked list of data 
structures or to examine a Sequence of memory locations. On terminal 
devices, you can use the escape key ( €0 ) to perform the same 
function as the REPEAT command; ESC provides a faster means of 
executing the command. 
Format 

REPEAT 

Qualifiers Defaults 
None None 
Parameters 

None 
Examples 


1. SDA> FORMAT @SCHSGQ_LEFWQ 


BO00631E9 PCRS. OSQFL 80062080 
BO0631E4 PCRSLSOBL. BOOOZONO 
BOOH31ES PCRSWOSTZE O07 
BOQE6SI1EA PCBS. TYRE OC 
BOO0S631ER POR SRO 18 


SQAs FORMAT @. 


BOO G2LT80 
BONS L084 
BOO62088 
BOOS6LTIBA 
BOOS 208% 


SUAS REPEAT 


BOO0G2F RO 
BOOS LF RA 
BOOS SF RE 
BOOG2F BA 
BOOS LE RES 


In this example, 


event 


+ 
+ 


¢ 


PCR BL. SQFL. 
PORSL UO SOQBL. 
PCR EWS Tak: 
PCRS EA TYRE 
PORS RORY 


e 


POR BLS QE TL. 
PORE SQEL, 
POBEW AS TZE 
POS 6B. TYRE 
POR SRR T 


¢ 


the wait queue is formatted, 
examined by using REPEAT (or by pressing €€ 


SOO0G62F RO 
BOOS STLEO 
00O7C 
Ot 
LS 


BQOO BOLO 
SOONG LTBO 
O07 UT 
OC 
1s 


the FORMAT command is used to examine the 
flag wait queue. 


local 


The first process control block (PCB) in 
then the rest of the 


queue can be 


) 
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SET OUTPUT 


The SET OUTPUT command writes the output of SDA commands to a file or 
device of your choice, If you set output to a file, SDA creates a 
table of contents that identifies the displays you selected. 


When you set SDA output to a file or device, SDA stops displaying 
commands at your terminal. If you finish directing SDA commands to an 
output file and wish to return to interactive display, you can issue 
another SET OUTPUT command uSing your terminal device as the file 
specification. You can also exit from SDA and then recall_ the 
utility. 


Format 


SET OUTPUT file-spec 


Qualifiers Defaults 
None None 
Parameters 


file-spec 


The device, directory, and file to which SDA output will be 
written. The default file specification is 
SYSSDISK: [default-dir]SYSDUMP.LIS. 


Examples 


1. SOAS SET OUTFUT BROKEN 
SUAS SHOW CRASH 
S0A> SHOW FROCESS/ALL. 
oOlAS SHOW SUMMARY 
OAS EXIT 


SDA stores the displays produced by the commands following SET 
OUTPUT on the current device and directory ina file called 
BROKEN.LIS. 


SDA COMMANDS 


SET PROCESS 


The SET PROCESS command moves process context to a specific process. 
This command allows you to examine the data structures associated with 
any given process. 


When you invoke SDA and specify a dump file, process context, that is, 
the virtual memory you will see upon executing SDA commands, defaults 
to the process that was executing when the system failed. If you are 
examining the running system, procesS context defaults to your 
process. 


When you issue a SET PROCESS command, process context changes to the 
process you specify. Many of the SDA commands, for example, EXAMINE, 
SHOW PROCESS and SHOW STACK, operate on the current process, that is, 
the context of the process specified in the last SET PROCESS command. 


SET PROCESS locates the information needed for the particular process 
but produces no output. 


You must specify one of the three SET PROCESS parameters or SDA _ will 
generate a syntax error. 


Format 
name 
SET PROCESS ~?/INDEX=nn 
/SYSTEM 
Qualifiers Defaults 
None None 
Parameters 
name 


A 1 to 31 character alphanumeric string assigned to the process. 
The dollar sign (S$) and underline (_) characters can be included 
in the string. 


/INDEX=nn 


The index to the software process control block (PCB). The index 
number (nn) is composed of the last four hexadecimal digits of 
the process identification (PID). 


/SYSTEM 


The system process control block. The system PCB and_= process 
header (PHD) are dummy structures that are located in system 
Space and contain the system working set, global section table, 
global page table, and other system-wide data. 


SDA COMMANDS 


Examples 


Ls SOAS SET FROCESS/INUEX=43 
STA’ EXAMINE/FO 


SDA locates the process by means of the index number and displays 
the contents of its program region. 


2 SDA> SET FROCESS SMITH 
SDA> SHOW STACK 


Setting the process to SMITH causes the SHOW STACK command to 
Gefault to SMITH rather than to the currently executing process. 


SDA COMMANDS 


SHOW CRASH 


The SHOW CRASH command displays fundamental information concerning the 
operating system and the currently executing process. The display can 
be divided into three sections: 


e Operating system and process information 
@e General and special register contents 


e Processor and hardware maintenance register contents 


Operating System and Process Information 

The first section of SHOW CRASH lists: 
e Date and time of the crash 
e Name and version number of the operating system 
e Name of the currently executing process 


e File specification of the image executing in the _ process 
context (left blank if no image is executing) 


e Interrupt Priority Level (in decimal) of the processor 


General and Special Register Contents 


The second section of the SHOW CRASH display lists the contents of the 
general purpose and special registers. 


e RO through Rll e Argument Pointer (AP) 
@e Frame Pointer (FP) @e Stack Pointer (SP) 
@e Program Counter (PC) e Processor Status Longword (PSL) 


Process and Hardware Maintenance Register Contents 


The third section of the SHOW CRASH display lists the contents of 
three sets of registers. The first set includes registers that store 
the vital statistics of the currently executing process, as well as 
registers that contain information used by the operating system. The 
second set of registers are the stack pointers for the processor 
access modes plus the interrupt stack. The third set of registers are 
used in hardware maintenance. 


The process and system registers are: 


POBR Program Region Base Register 

POLR Program Region Length Register 

P1BR Control Region BaSe Register 

P1LR Control Region Length Register 

SBR System Region Base Register 

SLR System Region Length Register 

PCBB Process Control Block Base Register 
SCBB System Control Block Base Register 

ASTLVL Asynchronous System Trap Level 

SISR Software Interrupt Summary Register 


5-21 
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The stack pointers are: 


ISP Interrupt Stack Pointer 

KSP Kernel Mode Stack Pointer 

ESP Executive Mode Stack Pointer 
SSP Supervisor Mode Stack Pointer 
USP User Mode Stack Pointer 


The hardware maintenance registers are: 


Iccs Interval Clock Control/Status Register 
ICR Interval Count Register 
TODR Time-of-Day Register 
ACCS Accelerator Control and Status Register 
SBIFS SBI Fault/Status Register 
SBISC SBI Silo Comparator Register 
SBIMT SBI Maintenance Register 
SBIER SBI Error Register 
SBITA SBI Timeout Address Register 
OBIS SBI Silo Register 
Format 
SHOW CRASH 
Qualifiers Defaults 
None None 
Parameters 
None 
Examples 


1. SDA* SHOW CRASH 


Figure 5-2 shows the display produced by this command. 
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VAX/VMS 2.0 -- System Dump Analysis 
System crash information 


Time of system crash: 


Version of system: VAX/VMS VERSION 1.50 


21=MAY-1979 10:57:48.99 


21-MAY-1979 14:42:49,464 


Reason for BUGCHECK exception: PGFIPLHI, Pagefault with IPL too high 


Process currently executing: GALCHER 


Current image file name: DB2:[(F4V2.TOOL] BLISS32.EXE;43 


Current IPL: 


(decimal) 


General registers: 


OO19CCAB 
8006BACN 
7FFDB998 
7FFEEBC4 
00070000 


Processor registers: 


POBR 
POLR 
P1BR 
P1LR 
SBR 
SLR 


ISP 
KSP 
ESP 
SSP 
USP 


tounia a i 


8010C400 
OO0003EE 
7F914400 
OOLFFEC9 
001FCO00 
00001000 


8007C200 
7FFEEB38 
7FFEFOOO 
7FFEF8 28 
7FFDB65C 


“ou wou 


PCBB 
SCBB 
ASTLVL 
SISR 
ICCS 
ICR 
TODR 


00000000 
7FFDFEOO 
0001910B 
7EFEEB7C 


Figure 5-2 


R2 


R190 
SP 


0012C678 
001D6A00 
00000004 
00180000 
800000C1 
FFFFF88F 
585540BA 


00008600 
N01 FFFBC 
0000255C 
7FFEEB38 


R3 


Rll 
PC 


8010C50C 
00000200 
7TFFE6C10 
80006074 


ACCS 

SBIFS 
SBISC 
SBIMT 
SBIER 
SBITA 
SBIS 


00008001 
00040000 
00000000 
00200200 
00008002 
00075CD8 
00000000 


System Crash Information 


SDA COMMANDS 


SHOW DEVICE 


The SHOW DEVICE command displays a formatted list of all data 
Structures associated with a device. The display for each device is 
divided into three sections: 


e Device data block lists 
e Controller data structures 
e Device unit data structures 


For a detailed explanation of I/O data structures displayed by SDA, 
consult Appendix A of the VAX/VMS Guide to Writing a Device Driver. 


Device Data Block (DDB) List 


The DDB list Shows information common to all devices associated with a 
Single controller. It shows: 


e Address of the controller status register (CSR) 
@e Name of the controller 

e Name of the ancillary control process (ACP) 

e Name of the I/O driver 

e Address of the driver prologue table (DPT) 


e Length of the I/O driver and DPT 


Controller Data Structures 


SDA displays the contents of the following four data structures 
associated with each controller: 


e Device Data Block (DDB) -- points to the driver dispatch 
table, the channel request block, and the first unit control 
block connected to the controller 


e Channel Request Block (CRB) -- stores information used_ to 
arbitrate requests between devices attached to ae single 
controller 

e Interrupt Dispatch Block (IDB) -- contains controller status 


information used to dispatch interrupts to the proper driver 


® Driver Dispatch Table (DDT) -- points to routines that process 
the I/O request 


Device Unit Data Structures 


The final section of the SHOW DEVICE display itemizes the contents of 
the Unit Control Block (UCB) for each device. If the device is 
handling file-structured requests, the display lists the Volume 
Control Block (VCB) and the ACP queue as well. 


SDA COMMANDS 


Unit Control Block (UCB) - SDA organizes the data stored in the UCB 
into a list of items. Heading the list are the address of next UCB, 
the status of the device, and the longword whose bits express various 
characteristics of the device. 


Following the heading, SDA lists pointers to other block types: 


I/O Request Packet (IRP) address 
Channel Request Block (CRB) address 
Volume Control Block (VCB) address 


The next six items on the list concern the fork block for the device 
driver: 


Fork Queue Forward Link (FQFL) 

Fork Queue Backward Link (FQBL) 
Fork Interrupt Priority Level (IPL) 
Fork PC, R3, and R4 


The UCB contains device status information: 


Device class 

Device type 

Device buffer size (DEVBUFSIZ) 

Device dependent data (DEVDEPEND) longword 
Device status (DEVSTS) longword 

Device IPL 

Reference count 

Operations count 


The final items detailed concern mailboxes and information obtained 
from the I/O request packet: 


Associated Mail Box (AMB) address 

System Virtual Page Number (SVPN) 

System Virtual Address of Page Table Entry (SVAPTE) 
Byte Offset (BOFF) 

Byte Count (BCNT) 

Error Retry Count (ERTCNT) 

Error Retry Maximum (ERTMAX) 

Error Count (ERRCNT) 

Owner UIC 

Process Identification (PID) 


SDA also formats all the I/O request packets queued to the UCB. The 
packet currently being processed is flagged by an asterisk (*). 
Information contained in each I/O request packet is listed in the 
following order across the page: 


Channel number (CHAN) 

Function value (FUNC) 

Window Control Block (WCB) 
Event flag number (EFN) 
Asynchronous system trap (AST) 
I/O status block (IOSB) 

Status flags (STATUS) 


If the request queue is empty, SDA issues the message: 


KKK I/O reauest queue is emrety kx 


SDA COMMANDS 


Volume Control Block and ACP Queue - If a volume was mounted on_ the 
device SDA reads and displays the contents of the volume control block 
(VCB) and the ancillary control process queue block (AQB). The VCB 
identifies the volume and contains counts and quotas concerning files 


on that volume. 
The ACP queue block contains information about the ancillary control 
process (ACP) associated with the volume. SDA reads the AQB and lists 
its contents in readable format. 
If the request queue is empty, SDA prints the message: 

KXX ACF request auewe is emrty KX 


Format 


SHOW DEVICE [device-name] 


Qualifiers Defaults 
None None 
Parameters 


device-name 


The name of a device whose data structures you want to display. 
The device name takes the form: 


devcu 
where 
dev = 2-alphabetic character device code 
Cc = l-alphabetic character controller designator 
u = l- or 2-digit device unit number 


You can display information about several devices by specifying a 
device code or a device code and controller. For example, SHOW 
DEVICE D lists all devices with device code Dn, where n 
corresponds to the second letter of the device code. SHOW DEVICE 
DBA lists all devices with device code DB and controller A. To 
display a single unit, specify the entire device name: SHOW 
DEVICE DBA1 displays the device associated with device name DBAI. 
If you do not specify a device name, SDA lists’ the data 
structures of every device on the system. 


Examples 
1 StA> SHOW DEVICE f 


Figure 5-3 is a sample Device Data Block list of all the devices 
attached to the system whose device codes start with D. This is 
an example of the first section of the display produced by SHOW 
DEVICE. 


VAX/VMS 2.0 -- System Dump Analysis 
I/O data structures 


DDB list 
Address Controller ACP Driver 
80000848 DRA F11ACP DRDRIVER 
8009A4C0 DMA F1L1ACP DMDRIVER 
8009AD00 DYA F11ACP DYDRIVER 
8009C560 DBA F11ACP DBDRIVER 
8009C620 DBB F11ACP DBDRIVER 
Figure 5-3 Device Data 
2 SoA: SHOW DEVICE DRA 
Figure 5~4 shows information on 
with DB device controller A. 
section of the display produced 
VAX/VMS 2.0 -- System Dump Analysis 


I/O data structures 


Control 


Device 


Channel 


ler: DBA 


Data Block (DDB): 
DDT address 

First UCB address 
CRB address 


Request Block (CRB): 

UCB reference count 
Channel allocation mask 
Secondary CRB address 
IDB address 

Controller init. routine 
Unit init. routine 

Unit start routine 

Unit disconnect routine 


Interrupt Dispatch Block (IDB): 


Driver 


CSR address 

Owner UCB address 
Number of units 
ADP address 


Dispatch Table (DDT): 
Start I/O routine 

Unsol. interrupt routine 
Function Decision table 
Cancel I/O routine 
Register dump routine 
Diagnostic buffer size 
Error buffer size 


Figure 5-4 


80040408 
8000087C 
8005EB20 


LL 

00 
00000000 
80075E40 
80001271 
800609DE 
00000000 
00000000 


80017800 
00000000 

8 
8005EBS50 


00000102 
00000637 
OON0007A 
8000A869 
00000592 

0080 

OOAE 


the 
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DPT 


80080410 
8008 21E0 
8008 2EC0 
80087640 
800874540 


DPT size 


0814 
O8FO 
O46 FO 
O5FO 
Of FO 


data 


Structures 


18-DEC-1979 11:38:52.74 


Block List for Dn Devices 


associated 


This is an example of the second 


by SHOW DEVICE. 


16-AUG-1979 16:34:54.81 


Controller Data Structures for DB Devices 


SDA COMMANDS 


3. Sta: SHOW DEVICE OBAIL 


Figure 5-5 shows an example of the last section 
produced by SHOW DEVICE. 


for the device DBAI. 


VAX/VMS 1.0 -- System Dump Analysis 


I/O data structures 


The display lists the 


DBAL 
UCB address: 80074B30 
Device status: 1810 online,valid,unload 
Characteristics: 1C4D4008 
IRP address 80089350 Device class 01 SVPN 
CRB address 8006B520 Device type 05 SVAPTE 
VCB address 80076140 DEVBUFSIZ 512 BOFF 
FQFL 80003A48 DEVDEPEND 032F1316 BCNT 
FOBL 80003A48 DEVSTS 0000 ERTCNT 
Fork IPL 8 Device IPL 21 ERTMAX 
Fork PC 80074831 Reference count 0 ERRCNT 
Fork R3 80019C80 Operation count 83765 Owner UIC 
Fork R4: 80019800 AMB address 00000000 PID 
***k T/O request queve is empty *** 
Volume: VMSWORK2 
Status: 80 system 
AQB address 8006E4A0 Cluster size 3 
Rel. Volume # 2 Reserved files 9 
Transactions 3 Maximum files 25000 
Mount count l Free blocks 19791 
Window size 7 Record size 0 
Default extension 5 RVT address 8008C8 20 
ACP for volume: DRASACP 
PID 00010042 
ACP type 3 
ACP class 0 
Status 04 defsys 
Mount count 7 
AQB linkage 00000000 


*** ACP request queue is empty *** 


Figure 5-5 


Device Unit Data 


of the 
UCB, VCB, 


display 
and AQB 


15-AUG-1979 17:10:06.68 


00000217 
8009835C 
0000 
0200 
8 
8 
1 
[ 1, 1] 
00000000 


Structures for Device DBAl]l 
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SHOW PAGE_TABLE 


The SHOW PAGE TABLE command displays a formatted list of system page 
table entries which are used to map virtual pages to physical pages. 


The display can be divided into left and right sections. The left 
section contains virtual page information. The right section contains 
physical page information. 


Virtual Page Information 


The left section of the display describes virtual pages using 
information contained in the system page table. Each line of this 
display lists characteristics of a particular virtual page as well as 
locations needed for address translation. The values listed are: 


@ ADDRESS -- system virtual address that marks the base of a 
virtual page 
@ SVAPTE -- system virtual address of the page table entry that 
maps this virtual page 
e PTE -- page table entry; longword that describes a system 
virtual page 
e Type -- type of virtual page; there are seven types: 
VALID Valid page (in main memory) 
TRANS Transitional page (between main 
memory and page lists) 
DZERO Demand-allocate-zero-fill page 
PGFIL Paging file page 
STX Section table index page 
GPTX Global page table index page 
IOPAGE I/O address space page 
@e PROT -- protection; a code derived from bits in the PTE that 


designate the type of access (read and/or write) granted to 
processor access modes (Kernel, Executive, SuperviSor, or 
User). 


e Bits -- letter(s) representing the value of a bit or a 
combination of bits in the PTE; indicates certain aspects of 
a page. The bit codes are: 


M Modify bit 
L Locked into working set 
K,E,S or U Access mode of owner of page 


(only one letter will appear) 
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Physical Page Information 


If the virtual page has been mapped to a physical page, the right 
section of the display includes information from the Page Frame Number 
(PFN) data base. Otherwise, the section is left blank. SDA organizes 
the 18 bytes of PFN data into nine categories: 


e PAGTYP -- type of physical page; there are six page types: 
PROCESS Process page 
SYSTEM system page 
GLOBAL Global section page 
PPGTBL Prcocess page table page 
GPGTBL Global page table page 
GBLWRT Global writeable section page 
e LOC -- location of page in system; there are eight locations: 
ACTIVE In working set 


MDFYLST In modified page list 
FREELST In free page list 
BADLST In bad page list 
RELPEND Release pending 
RDERROR Read error 

PAGEOUT Paging out 


PAGEIN Paging in 
e STATE -- byte that describes the state of the physical page. 
e TYPE -- byte that describes the type of virtual page (see 
PAGTYP). 
@e REFCOUNT -- reference count; word indicating the presence of 
a reference to this PFN. If the value of REFCOUNT is 
non-zero, the page is used in at least one working set. Tf 


the value is zero, the page is not used in any working set. 


e BAK -- backing store address; location on a disk device to 
which pages can be written 


e SVAPTE -- virtual address associated with this page frame. 
The two SVAPTES indicate a valid link between physical and 
virtual address space. 


@e FLINK -- forward link within PFN data base; also acts as’7 the 
Share count of a global section. 


e BLINK -- backward link within PFN data base; also acts aS_ an 
index to the working set list. 


SDA indicates pages that cannot be accessed with the message: 
someon NULL PAGES 


where n represents the number of inaccessible pages. 
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Format 


SHOW PAGE TABLE 


Qualifiers Defaults 

/GLOBAL 

/SYSTEM 

/ALL /ALL 
Parameters 
None 
Qualifiers 
/GLOBAL 

Lists the global page table. 
/SYSTEM 

Lists the system page table. 
/ALL 

Lists both the global and system page tables. This 

default for the command. 
Examples 


1. SAS SHOW FAGE.. TABLE/SYSTEM 


Figure 5-6 showS one page of the display produced 
command. 


is 


by 


the 


this 


CE-S 


ADDRESS 


8000D000 
8000D200 
8000D400 
8000D600 
8000D800 
8000DA00 
8000DC00 
8000DE00 
8000E000 
8000E200 
8000E400 
8000E600 
8000E800 
8000EA00 
8000ECO00 
8000EE00 
8000F000 
8000F200 
8000F400 
8000F600 
8000F800 
8000FA00 
8000FC00 
8000FE00 
80010000 
80010200 
80010400 
80010600 
80010800 
80010A00 
80010C00 
80010E00 


— oe ee ee we oe oe oe 


80014600 
80014800 
80014A00 
80014C00 
80014E00 
80015000 
80015200 
80015400 
80015600 
80015800 
80015A00 
80015C00 
80015E00 
80016000 
80016200 
80016400 
80016600 


27 


SVAPTE 


801F91A0 
801F91A4 
B01 F91A8 
801 F91AC 
801F91B0 
801F91B4 


801F91B8 


801F91BC 
801F91C0 
801F91C4 
801F91C8 
801 F91CC 
801F91D0 
801 F91D4 
801F91D8 
801 F91DC 
801F91E0 
801 F91E4 
801 F91E8 
SOLF9ILEC 
801 F91FO 
801 F91F4 
SO1LFOLFS 
801F91FC 
801F9200 
801F9204 
801F9208 
801F920C 
801F9210 
801F9214 
801F9218 
801 F921C 


PTE 


78000B7A 
F80004E9 
78000134 
F80009E5 
F8000DB2 
F80001DD 
F80001E9 
F8000257 
F800098E 
FS000A5B 
F800049A 
F8000844 
F8000075 
78000088 
F800020A 
F8000270 
F8000A4C 
78000096 
F800067B 
780001E5 
F800031A 
F800029A 
7800098C 
7C40FFF8 
F80002DC 
78000159 
TC40FFF8 
7C40FFF8 
7C40FFF8 
7C40FFF8 
7C40FFF8 
F80009F7 


NULL PAGES 


801 F928C 
801F9290 
801F9294 
801F9298 
801F929C 
801F92A0 
801 F92A4 
801F92A8 
801F92AC 
801F92B0 
801F92B4 
801F92B8 
801 F92BC 
801 F92C0 
801 F92C4 
801 F92C8 
801F92CC 


94100010 
94100030 
90100031 
90100032 
90100033 
94100034 
94100035 
90100036 
90100037 
941009F0 
901009F1 
901009F2 
901009F3 
941009F4 
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SHOW PFN_DATA 


The SHOW PFN DATA command displays a formatted list of values 
contained in the page lists and in the PFN data base that can be used 
to translate physical pages to virtual pages. 


There are four data structures concerned with the management of 
physical memory: 


e Free Page List -- pages available for use 

@e Modified Page List -- pages to be written to disk 
e Bad Page List -- pages containing data errors 

e PFN Data Base -- all pages in physical memory 


To display a particular physical page, specify its page frame number 
(PFN). To list the pages of one or more data structures, use the 
qualifiers. If you do not specify a parameter or a qualifier, SDA 
will dump all the page lists and the entire PFN data base. 


The format used to display physical page data is the same for. each 
data structure, Figure 5-7 shows a page of the display produced by 
the command SHOW PFN DATA/SYSTEM. SDA organizes the information for 
each page under the following headings: 


e PFN -- page frame number; the absolute page number within 
physical memory 


e PTE ADDRESS -- Page Table Entry address; the virtual address 
of the Page Table Entry (See the description of the SHOW 
PAGE TABLE command for more details). 


e BAK -- backing store address; location on a disk device to 
which pages can be written 


@ REFCNT -- reference count; a word whose value signals whether 
a page is part of a working set 


e FLINK -- forward link; forward link within the PFN data base 
(also used as share count of a global section) 


e BLINK -- backward link; backward link within the PFN data 
base (also used as an index to the working set list) 


e TYPE -- type of page that was mapped into physical memory (see 
the description of the SHOW PAGE TABLE command for a list of 
the different types) 


e STATE -- current state of the page in the system (see _ the 
description of the SHOW PAGE TABLE command for a list of 
States) 
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Format 
SHOW PFN DATA [number] 
Qualifiers Defaults 
/FREE 
/MODIFIED 
/BAD 
/SYSTEM 
/ALL /ALL 
Parameters 
number 
The number of the physical page you want to display. 
Qualifiers 
/FREE 
Displays the free page list. 
/MODIFIED 


Displays the modified page list 


/BAD 
Displays the bad page list. 

/SYSTEM 
Displays the PFN data base in order of PFN starting at page frame 
ZeLO. 

/ALL 
Displays all of the above memory management data structures. 
This is the default for the command. 

Examples 


1. SUAS SHOW FFNOIDATA/SYSTEM 


Figure 5-7 showS one page of the display produced by this 
command. 
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VAX/VMS 2.0 -- System Dump Analysis 
PFN data base 


21-MAY-1979 15:00:04.82 


PEN PTE ADDRESS BAK REFCNT FLINK BLINK TYPE STATE 
0000 00000000 00000000 0 0895 OAAF 00 PROCESS 00 FREELST 
0001 800A3C10 03000000 1 0000 0053 00 PROCESS 87 ACTIVE 
0002 80174EA0 03000000 1 0000 007C 00 PROCESS 87 ACTIVE 
0003 8010CEEO 033FFFFF 1 0000 O1A2 00 PROCESS 87 ACTIVE 
0004 801F7F70 03000000 1 0000 00c9 00 PROCESS 07 ACTIVE 
0005 8010CEB4 033FFFFF 1 0000 018D 00 PROCESS 87 ACTIVE 
0006 80174CAC 03000000 1 0000 OOCE 00 PROCESS 07 ACTIVE 
0007 8016D200 03005351 0 002D 0498 00 PROCESS 00 FREELST 
0008 8010CE2C 0300E2DE 0 OD05 095F 00 PROCESS 81 MDFYLST 
0009 801C0C58 03000000 1 0000 OODB 00 PROCESS 07 ACTIVE 
000A 801FB890 03000000 1 0000 0054 04 PPGTBL 07 ACTIVE 
000B 801FC6BC 03000000 1 0000 004B 04 PPGTBL 87 ACTIVE 
000C 00000000 00000000 0 0566 O8Bl 00 PROCESS 00 FREELST 
000D 801FD3E0 OO040FFB8 1 0002 0000 02 GLOBAL 07 ACTIVE 
OO0OE 801FD474 OO40FFA0 0 O3FB OD11 02 GLOBAL 00 FREELST 
OO0F 8010CF1C 033FFFFF 1 0000 0084 00 PROCESS 87 ACTIVE 
0010 80101040 033FFFFF 1 0000 008C 00 PROCESS 87 ACTIVE 
0011 801FD524 O0040FF90 1 0002 0000 02 GLOBAL 07 ACTIVE 
0012 8017C9D0 03000000 1 0000 0047 00 PROCESS 07 ACTIVE 
0013 80113F88  0300E2C6 1 0000 014B 00 PROCESS 07 ACTIVE 
0014 8011F480 03000000 L 0000 00B8 00 PROCESS 07 ACTIVE 
0015 801F0464 03000000 1 0000 006B 00 PROCESS 07 ACTIVE 
0016 8010C610 O040FFE8 0 00D1 0195 00 PROCESS 00 FREELST 
0017 8016D3BC 03000000 1 0000 OOFE 00 PROCESS 07 ACTIVE 
0018 800B50D8 03000000 1 0000 005D 00 PROCESS 07 ACTIVE 
0019 8016D338 03000000 1 0000 0143 00 PROCESS 07 ACTIVE 
OO1A 801FB774 03000000 i 0000 004E 04 PPGTBL 87 ACTIVE 
001B 8016D254 033FFFFF 0 O18E 0634 00 PROCESS 81 MDFYLST 
O01C 801D20D8 033FFFFF 1 0000 00B4 00 PROCESS 87 ACTIVE 
001D 8O1FD5FO 0040FF90 1 0002 0000 02 GLOBAL 07 ACTIVE 
OOLE 8010A8D8 03005305 1 0000 0175 00 PROCESS 87 ACTIVE 
001F 801FD6DC 0040FF70 1 0001 0000 02 GLOBAL 07 ACTIVE 
0020 8011D848 O33FFFFF 1 0000 00D2 00 PROCESS 87 ACTIVE 
0021 8010CFEO 033FFFFF 1 0000 0O0DC 00 PROCESS 87 ACTIVE 
0022 801B59D4 03000000 1 0000 00464 00 PROCESS 07 ACTIVE 
0023 00000000 00000000 0 020C 025B 00 PROCESS 00 FREELST 
0024 80174CA4 03000000 j 0000 00cc 00 PROCESS 07 ACTIVE 
0025 00000000 00000000 0 OA2E 08CB 00 PROCESS 00 FREELST 
0026 8010CE34  0300E2E0 0 0590 0423 00 PROCESS 81 MDFYLST 
0027 801FCB6C 03000000 i 0000 004F 04 PPGTBL 87 ACTIVE 
0028 8010CA28  O040FFE8 1 0000 00C5 00 PROCESS 07 ACTIVE 
0029 8010CC98 033FFFFF 0 OA25 OCC5 00 PROCESS 81 MDFYLST 
002A 801601F4 03008FF2 1 0000 0058 00 PROCESS 87 ACTIVE 
002B 8010C604 O040FFE8 0 O7AC OD1E 00 PROCESS 00 FREELST 
002Cc 8016D348 03000000 1 0000 0135 00 PROCESS 07 ACTIVE 
002D 8016D204 03008352 0 04D1 0007 00 PROCESS 00 FREELST 
002E 801A2838  0300861C 1 0000 00D7 00 PROCESS 87 ACTIVE 
002F 00000000 00000000 0 0840 0B03 00 PROCESS 00 FREELST 
0030 801FD2E8 0040FFDO 1 0003 0000 02 GLOBAL 07 ACTIVE 
0031 00000000 00000000 0 093A O8CD 00 PROCESS 00 FREELST 
0032 8010C7C4 0040FFE8 1 0000 017A 00 PROCESS 07 ACTIVE 
Figure 5-7 PFN Data Base 
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SHOW POOL 


The SHOW POOL command displays the contents of the I/O Request Packet 
(IRP) pool, the nonpaged dynamic storage pool, and the paged dynamic 
Storage pool. This data is organized into blocks; SDA attempts’ to 
identify each block by its block type. SHOW POOL displays only 
allocated blocks, that is, blocks that are (or were) currently in use 
by the system. 


The information contained in each of the three pools is shown in the 
same format. From left to right, the contents of the display are: 


e Block type -~ the type of information contained in the block. 
SDA tries to define the block type. If it is unable to do so, 
the message UNKNOWN is printed instead of the name of the 
block type. 


e Starting address -- the virtual address that marks the start 
of the block. 


e Block size -- the number (decimal) of bytes of nonpaged memory 
allocated to the block. The block size is fixed at 80 in the 
IRP pool and is variable in the paged and nonpaged pools. 


e Contents (hexadecimal) -- the contents of the block in 
longwords. The contents are arranged four columns across. 


e Contents (ASCII) -- the contents of the block in ASCII format. 
Format 
SHOW POOL 
Qualifiers Defaults 
/IRP 
/NONPAGED 
/ PAGED 
/SUMMARY 
/ALL /ALL 
Parameters 
None 
Qualifiers 
/IRP 


Prints the I/O request packet pool. Formats all blocks currently 
allocated (in use) within this pool. 


/NONPAGED 


Prints the nonpaged dynamic storage pool currently in use by the 
system. 
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/ PAGED 


Prints the paged dynamic storage pool currently in use by the 
system. 


/ SUMMARY 


/ALL 


Prints a summary of the pools selected by the above qualifiers. 
/SUMMARY displays the different block types present and lists the 
total number and bytes used of each in decimal. This qualifier 
also prints the total number of bytes used in each pool. 


Prints IRP, nonpaged, and paged dynamic storage pools. This is 
the default for the command. 


Examples 


1. 


Stas SHOW POOL /PAGEN 


Figure 5-8 shows a page of the display produced by this command. 
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VAX/VMS 2.0 -~- System Dump Analysis 
Paged dynamic storage pool 
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SDA COMMANDS 


SHOW PROCESS 


The SHOW PROCESS command displays the software and hardware context of 
any process in the balance set. 


Format 
[name ] 
SHOW PROCESS < [/INDEX=nn] 
[/SYSTEM] 
Qualifiers Defaults 
/ PCB /PCB 
/PHD 
/REGISTERS 


/WORKING_ SET 
/PROCESS SECTION TABLE 
/PAGE_ TABLES 


/ALL 

Parameters 

name 
A 1l- to 15-character alphanumeric string assigned to the process. 
The name can include the symbols underline (_) and dollar sign 
(S). 

/INDEX=nn 
The index to the software PCB; nn consists of the last four 
hexadecimal digits of the Process Identification (PID). 

/SYSTEM 


The system process control-block. The system PCB and_= process 
header (PHD) are dummy structures’ that are located in system 
space and contain the system working set, global section table, 
global page table, and other system-wide data. When you specify 
this parameter, SDA displays the system PCB rather than a_e given 
process. | 


If no parameter is specified, the command displays the current 
process. See the description of the SET PROCESS command for the 
definition of the current process. 


Qualifiers 
/PCB 
Produces a formatted list of the data contained in the software 


process control block (PCB). The software PCB is the central 
control mechanism for procesS swapping and scheduling. 
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The display produced by the /PCB qualifier lists: 

e Software context for the process 

e Condition handling information 

e Interprocess communication data 

e Counts and quotas 
/PCB is the default display for the command. 

/PHD 

Lists information included in the process’ header. The process 
header contains a process's vital statistics and is swapped into 
memory when a process becomes part of the balance set. Each item 
listed by the /PHD qualifier gives a quantity, count, or limit 
for the process concerning: 

® Process memory 

@® Pager 

e® Scheduler 

e Asynchronous system traps 

e 1/0 activity 

e CPU activity 


/REGISTERS 


Lists the process's hardware context. When a process executes, 
its hardware context is saved in the processor registers (see the 
description of the SHOW CRASH command). If the process is not 
executing, its hardware context is stored in the hardware PCB, 
which is part of the process header. The /REGISTERS qualifier 
organizes the saved process registers into: 


e General-purpose registers 

e Stack pointers 

e Special-purpose registers 

e Base and length registers 

/WORKING SET 

Displays the working set list for the process. The working set 
list is a table for all virtual pages residing in physical memory 
that the process can access without a page fault. The values 
exhibited by this command are: 


e INDEX -- index used in PFN data base to access the entry 


e ADDRESS -- address of a virtual page in the _ process 
address space : 


e STATUS -- a 3-part section that lists the location of the 
page in physical memory, the type of page (see the 
description of the SHOW PAGE TABLE command), and whether 
the page is locked into the working set 
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When SDA locates an unused working set entry, it issues’7 the 
message: 
---- n empty entries 


The value of n is the number (in decimal) of unused entries’ that 
SDA has found. 


/PROCESS SECTION TABLE 


Lists data within the process section table. The process section 
table contains information needed to locate a page in a process 
section. SDA notes the boundary of the Process Section Table in 
the "Process Section Table Information" section of the listing 
and then displays the actual process section table in readable 
format. The parts of the process section table are: 


e INDEX -- the word that locates the corresponding process 
section table entry 


e ADDRESS -- the virtual address in the program region that 
marks the location of a process Section table page 

e PAGES -- the length of a process section in pages 

e WINDOW -- the mapping window that translates virtual 


block numbers to logical block numbers 


e VBN -- virtual block number; the number of a block on a 
mass storage device (the block number is relative to a 
file rather than to a device) 


e CLUSTER -- the cluster factor used when faulting pages in 
the corresponding process section 


e CHANNEL -- the channel number connecting a _ process 
section to a device unit 


e REFCNT -- a number that indicates whether the page is 
part of a working set 

@e FLINK -- the forward link word in the PST list 

e BLINK -- the backward link word in the PST list 

e FLAGS -- the flags that describe the process’ section 


during process execution 


/PAGE TABLES 


/ALL 


Displays the program and control region page tables. 
/PAGE TABLES produces a list in the same format as the SHOW 
PAGE TABLE command. 


Displays the information produced by the /PCB, /PHD, /REGISTERS, 
/WORKING SET, /PROCESS SECTION TABLE, and /PAGE_TABLES 
qualifiers. 
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Examples 
is SOAS SHOW FROCESS/FCR 
The top portion of Figure 5-9 shows the display produced by this 
command. 
Zs STAs SHOW FROCESS/FHE 
The middle portion of Figure 5-9 shows the display produced by 
this command. 
3% STAs SHOW FROCESS/REGISTERS 
The bottom portion of Figure 5-9 shows the display produced by 
this command. 
VAX/VMS 2.0 ~=- System Dump Analysis 3-JAN-1980 16:54:45.57 
Process 2B dump: ELDRIDGE 
Process status: 00040001 RES , PHDRES 
PCB address 8008BD20 JIB address 8009DB80 
Master PID 0004002B Creator PID 00000000 
PID 0004002B Subprocess count 0 
PHD address 80180A00 Swapfile disk address 00000000 
State LEF Termination mailbox 0000 
Current priority 9 AST’s enabled KESU 
Base priority 4 AST's active NONE 
UIC [011,013] AST's remaining 14 
Mutex count 0 Buffered I/0 count/limit 5/6 
Waiting EF cluster 0 Direct I/O count/limit 6/6 
Starting wait time 00000000 BUFIO byte count/limit 12056/12336 
Event flag wait mask F7FFFFFF # open files allowed left 10 
Local EF cluster 0 40000318 Timer entries allowed left 10 
Local EF cluster 1 80000041 Active page table count 0 
Global cluster 2 pointer 00000000 Process WS page count 235 
Global cluster 3 pointer 00000000 Global WS page count 14 
Process header 
First free PO address 0002C800 Accumulated CPU time 00001446 
Free PTES between P0/P1 7478 CPU since last quantum 0031 
First free Pl address 7FFD3200 Subprocess quota 8 
Free page file pages 25252 AST limit 16 
Page fault cluster size 127 Process header index 0018 
Page table cluster size 2 Backup address vector 03A5 
Flags 0002 WSL index save area 0380 
Direct I/O count Ted PTs having locked WSLs 2 
Buffered I/O count 4958 PTs having valid WSLs A 
Limit on CPU time 00000000 Active page tables 7 
Maximum page file count 25600 Maximum active PTs 7 
Total page faults 7154 Guaranteed fluid WS pages 20 
File limit 16 Extra dynamic WS entries 360 
Timer queue limit 10 Locked WSLE counts array OFB8 
Paging file index 03000000 Valid WSLE counts array OFF8 
Saved process registers 
RO = 08000000 Rl = 00000000 R2 = 80001AD0 R3 = 8008BD70 
R4 = 8008BD20 RS = 00000000 R6 = 000008DC R7 = 00000003 
R8 = 7FFD5A58 R9 = 7FFDC120 R10 = 7FFDCO008 Rll = 7FFDBA8C 
AP = 7FFD590C FP = 7FFD5914 PC = 80000328 PSL = 03C00000 
KSP = 7FFEE400 ESP = 7FFEFOO00 SSP = 7FFEF878 USP = 7FFD590C 
POBR = 80181C00 POLR = 00000164 PIBR = 7F989C00 PILR = OOLFFE9A 
Figure 5-9 Process Information 
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4. SOAs SHOW FROCESS/WORKING. SET 
Figure 5-10 shows the display produced by this command. The size 
of the working set and its boundaries are listed at the head of 
the display. The actual working set list follows this 
information. 

VAX/VMS 2.0 -- System Dump Analysis 21-MAY-1979 15:19:08.57 


Process 34 dump: GROVE 


Working set information 


First WSL entry 0046 Current authorized working set size 1000 
First locked entry 0051 Default (initial) working set size 350 
First dynamic entry 0052 Maximum working set allowed (quota) 1000 
Last entry replaced O15A 
Last entry in list 0O1A3 
Working set list 

INDEX ADDRESS STATUS 

0046 7FFEEAOO VALID PROCESS WSLOCK 

0047 7FFEE800 VALID PROCESS WSLOCK 

0048 7FFEE600 VALID PROCESS WSLOCK 

0049 7FFEFEOO VALID PROCESS WSLOCK 

004A 8010AC00 VALID PPGTBL WSLOCK 

004B 8010AE00 VALID PPGTBL WSLOCK 

004C 8010B000 VALID PPGTBL WSLOCK 

004D 8010C000 VALID PPGTBL WSLOCK 

OO4E 8010C200 VALID PPGTBL WSLOCK 

0O0O4F 80113E00 VALID PPGTBL WSLOCK 

0050 80114000 VALID PPGTBL WSLOCK 

0051 8010B200 VALID PPGTBL WSLOCK 


0052 00054400 
0053 00054A00 
0054 00055400 
0055 00054E00 
0056 00054C00 
0057 00055000 
0058 00055200 
0059 00063500 
005A 00056600 
005B 00055600 
005C 00068E00 
005D 00055C00 
OO5E O0O05BE00 
OO5F 00069000 
0060 00056200 
0061 00056400 
0062 00069200 
0063 00056A00 
0064 00069400 
0065 00056C00 
0066 00056E00 
0067 00064000 
0068 00069600 
0069 0005C400 
006A 00057200 
006B 00057400 
006C 00059200 
006D 00059000 
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VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 
VALID PROCESS 


Figure 5-10 Working Set List 


SDA COMMANDS 


21-MAY-1979 15:29:24.54 


Ds S0A> SHOW FROCESS/PROCESS SECTION. TABLE 
Figure 5-11 shows the display produced by this command. 
VAX/VMS 2.0 -- System Dump Analysis 
Process 34 dump: GROVE 
Process section table information 
Last entry allocated FFEO 
First free PST entry 0000 
Process section table 
INDEX ADDRESS PAGES WINDOW VBN CLUSTER CHANNEL - REFCNT 
FFF8 00000200 OO00000F 8006B980 00000002 0 7FFE1DEO 0 
FFFO 00076600 00000008 80078050 00000002 0 7FFE1D90 7 
FFE8 00003C00 00000188 8006B980 00000013 O 7FFE1DEO 355 
FFEO 00077600 00000033 80079220 0000019C 0 7FFE1D60 oul 
Figure 5-l1l Process Section Table 
6. SDA> SHOW PROCESS/PAGE_TABLES 


Figure 5-12 shows a portion of the 


command. 


display produced 


44 


un 
| 


FLINK 


FFE8 
FFFO 
FFF8 
FFEO 


by 


BLINK 


FFE8 
FFFO 
FFF8 
FFEO 


this 


FLAGE 


VAX/VMS 2.0 -- System Dump Analysis 
Process 01 dump: SWAPPER 


22-MAY-1979 10:40:52.99 


PO page table 


GvV-S 


ADDRESS SVAPTE PTE TYPE PROT BITS PAGTYP LOC STATE TYPE REFCNT BAK SVAPTE FLINK BLINK 
00000000 8005EE30 DOOOOB6D VALID SRKW K PPGTBL ACTIVE 87 04 1 03000000 801FA7D8 0000 004A 
00000200 8005EE34 DOOOOG66E VALID SRKW K PPGTBL ACTIVE 87 04 1] 03000000 801FA900 OO0F 0050 
00000400 8005EE38 D40009DD VALID SRKW M K PROCESS ACTIVE 07 00 1 03000000 800C81FC 0000 0049 
00000600 800SEE3C D0000075 VALID SRKW K PROCESS ACTIVE 87 00 1 03000000 800C803C 0000 0051 
00000800 8005EE40 DN000B77 VALID SRKW K PROCESS ACTIVE 87 00 i 03000000 800C80C8 O000 0052 
00000A00 8005EE44 DO0000B73 VALID SRKW K PROCESS ACTIVE 07 00 1 03000000 800C81D4 0000 0046 
00000C00 8005EE48 DOOOO5FB VALID SRKW K PROCESS ACTIVE 07 00 1 03000000 800C81D0 0000 0047 
00000£00 800SEE4C D4000C4C VALID SRKW MK PROCESS ACTIVE 07 00 1 03000000 800c81CC 0000 0048 
00001000 8005EE50 DOOOO9DD VALID SRKW K PROCESS ACTIVE 07 00 1 03000000 800C81FC 0000 0049 
00001200 8005EE54 D0000075 VALID SRKW K PROCESS ACTIVE 87 00 1 03000000 800C803C 0000 0051 
00001400 8005EE58 D0000B77 VALID SRKW K PROCESS ACTIVE 87 00 1 03000000 800C80C8 0000 0052 
00001600 8005EE5C D4000290 VALID SRKW M K PPGTBL ACTIVE 87 04 1 03000000 801FA7E0 0000 004C 
00001800 8005EE60 D4000397 VALID SRKW M K PPGTBL ACTIVE 87 04 1 03000000 801FA7DC 0000 0048 
=== 1 NULL PAGES 
00001C00 8005EE68 DOOOOAAG VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 O5E4 0288 
00001E00 8005EE6C D0000960 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 01C9 OOAE 
00002000 8005EE70 DOOOO1CB VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0271 0456 
00002200 800SEE74 DOOOOD04 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 OBC1 O0C32 
00002400 8005EE78 DOOOOS5A0 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0596 0523 
00002600 8005EE7C DO000271 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0331 O1CB 
00002800 8005EE80 DOOO0OBC7 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 049E OBCA 
00002A00 8005EE84 D0000066 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 O6DF 0384 
00002C00 8005EE88 D0000076 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 O0CB O9FO 
00002E00 8005EE8C DO000C32 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 OD04 O80C 
00003000 8005EE90 D000080C VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0c32 0539 
00003200 8005EE94 D0000539 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 o80c 0038 
00003400 8005EE98 DOOOOBC1 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0456 oD04 
00003600 8005EE9C DOOOO6AA VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 ODD8 OB24 
00003800 8005EEAO DOOOODES VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 opD1 ocsc 
00003A00 8005EEA4 DOOOOA9B VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 09A7 0044 
00003c00 8005EEA8 D0000012 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0779 O8BA 
00003E00 800SEEAC D000094D VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 04E7 O03FC 
00004000 8005EEBO D0000448 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0763 0839 
00004200 8005EEB4 DOO007E5 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0557 0AaAc3 
00004400 8005EEB8 D0000456 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 01cB_ OBC1 
00004600 8005EEBC DOOOOO6F VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0952 ODE8 
00004800 8005EECO DOOOODCC VALID SRKW K GLOBAL FREELST 00 02 0  OO40FFO8 801FE2E4 054C O75E 
00004A00 800SEEC4 DOOOODBY VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 O70F OOCE 
00004c00 8005EEC8 D0000234 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 OA8B 067B 
00004E00 8005EECC DOOOOASY9 VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 OO9A 0557 
00005000 8005EEDO D000074B VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0407 040A 
00005200 800S5EED4 D000083B VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0050 0522 
00005400 8005EED8 D0000900 VALID SRKW K GLOBAL FREELST 00 02 0 OO4CFFDO 801FD34C 074D O8E0 
00005600 800SEEDC DOOOO70F VALID SRKW K PROCESS FREELST 00 00 0 00000000 oo000Gc00 O86A ODBI 
00005800 8005EEEO D00002CcB VALID SRKW K PROCESS FREELST 00 00 0 00000000 00000000 0511 0889 

Figure 5-12 Program Region Memory 
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SDA COMMANDS 


SHOW STACK 


The SHOW STACK command displays the location and contents of the four 
Stacks used by a given process as well as the system-wide interrupt 
Stack. 


Each qualifier displays one of four stacks that correspond to the four 
VAX/VMS processor access modes for a specific process. The /INTERRUPT 
qualifier displays the system-wide interrupt stack. The default for 
SHOW STACK is’ the stack that is currently being used or that was in 
use when the system failed. 


Figure 5-13 shows the display produced by the SHOW STACK command. The 
display is the same for each stack, and is composed of four sections: 


e Stack Pointer -- the stack pointer identifies the top of the 
stack. The display indicates the stack pointer by the symbol: 


SF => 7FFEFS68 00000001 


@e Stack address -- SDA lists all the virtual addresses allocated 
to the stack by the operating system. The stack addresses are 
listed in a column which increases by 4 (one longword). 


e Stack contents -- SDA lists the contents of the stack in a 
column next to the stack addresses. 


e Global symbols -- SDA attempts to display the contents of a 
location symbolically using a symbol and an offset. For 
example: 

7FFEF868 7FFEE2ZOO MMGSHIRBUF 
7FFEFS86C 7FFEE2O8 MMGSHOIRBUF+O8 


If the value is not within range of any existing symbols, the 
field will be left blank. 


If a stack is empty, the stack pointer will point to the message: 
GF sels (THE STACK IS EMPTY) 
SDA will display only five pages of any stack. 
Format 
SHOW STACK 
Qualifiers Defaults 
/ INTERRUPT Stack currently in use (running system) 
or in use when system failed 
/KERNEL 
/EXECUTIVE 
/SUPERVISOR 
/USER 
/ALL 


Parameters 


None 
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SDA COMMANDS 


Qualifiers 
/INTERRUPT 


Displays the interrupt stack. This stack is always resident in 
memory and is used during hardware interrupt processing. 


/KERNEL 

Displays the kernel stack for the current process. 
/EXECUTIVE 

Displays the executive stack for the current process. 
/SUPERVISOR 

Displays the supervisor stack for the current process. 
/USER 

Displays the user stack for the current process. 
/ALL 

Displays all the stacks described above. 
Examples 
1. SUA SHOW STACK/KERNEL 


Figure 5-13 shows a portion of the display produced by this 
command. 


VAX/VMS 2.0 -- System Dump Analysis 


Current operating stack 


Current operating stack (KERNEL): 


SP 


7FFEEB18 
7FFEEBIC 
7FFEEB20 
7FFEEB24 
7FFEEB28 
7FFEEB2C 
7FFEEB30 
7FFEEB34 


7FFEEB38 
7FFEEB3C 
7FFEEB40 
7FFEEB44 
7FFEEB48 
7FFEEB4C 
7FFEEBSO 
7FFEEBS4 
7FFEEB58 
7FFEEBSC 
7FFEEB60 
7FFEEB64 
7FFEEBH8 
7FPFEEB6C 
7FFEEB70 
7FFEEB74 
7FFEEB78 
7FFEEB7C 
7FFEEB80 
7FFEEB84 
7FFEEB88 
7FFEEB8C 
7FFEEB9O 
7FFEEB94 
7FFEEB98 
7FFEEB9C 
7FFEEBAO 
7FFEEBA4 
7FFEEBA8 
7FFEEBAC 
7FFEEBBO 
7FFEEBB4 
7FFEEBB8 
7FFEEBBC 
7FFEEBCO 
7FFEEBC4 
7FFEEBC8 
7FFEEBCC 
7FFEEBDO 
7FFEEBD4 
7FFEEBDS8 
7FFEEBDC 
7FFEEBEO 
7FFEEBE4 


00001000 
7FFEEB20 
7FFEFOOO 
7FFEF8 28 
7FFDB65C 
8007C200 
80006074 
00070000 


8006BACO 
7FFDFEOO 
00000000 
801F1868 
80007814 
00070000 
00000000 
00000002 
00020004 
8000C4DF 
8000C487 
3FFFFFFF 
00000000 
8000771F 
00000000 
00000000 
00000000 
00000000 
00000000 
7FFEEBC4 
7FFEEB98 
8000B4E3 
80000116 
00800000 
00000000 
20FC0000 
7FFEF854 
7FFEEBE4 
8000BBF7 
7FFEEBD4 
7FFE1LDFO 
8006BACO0 
7FFDFEOO 
FFFFFFSF 
00000003 
00000003 
7FFEEBD4 
00000000 
00000000 
3FFFFFFF 
00000000 
00000000 
80008E38 
00000000 


Figure 5-13 


SDA COMMANDS 


21-MAY-1979 15:34:40.49 


CTLSGL_KSTKBAS+520 
CTLSGL_KSPINI+400 
CTLSGL_KSPINI+C28 


EXESSWAPINIT+9F8 


MMG SEXTRADYNWS+164 


EXESDELTVA+0AA 
EXESDELTVA+052 


MMGS EXTRADYNWS+06F 


CTLSGL_KSTKBAS+5C4 
CTLSGL KSTKBAS+598 
EXESCMODEXEC+0D3 
SYSSDELTVA+006 


CTLSGL KSPINI+C54 
CTLSGL KSTKBAS+5E4 
MMG S$ IMGRESET+030 
CTLSGL KSTKBAS+5D4 
CTLSGL CCB 


CTLSGL_KSTKBAS+5D4 


EXESRUNDWN+04E 


Current Operating Stack (Kernel) 


SDA COMMANDS 


SHOW SUMMARY 


The SHOW SUMMARY command displays a formatted list of all active 
processes. The display shows the values used in swapping = and 
scheduling for these processes. Figure 5-14 iS an example of the 
display produced by the SHOW SUMMARY command. The information listed 
in the display includes: 


e PID -- the 32 bit quantity that uniquely identifies’ the 
process 

e PROCESS NAME -- the name assigned to the process 

@ IMAGE NAME -- the VAX/VMS file specification of the image 
currently executing in the process's context 

e STATE -- the condition of the process (see the VAX/VMS System 
Manager's Guide for a description of possible states) 

e PRI -- the current scheduling priority of the process 

e UIC -- User Identification Code 

@e WKSET -- the total number (in decimal) of pages currently in 


the working set 


If the process has been swapped out of the balance set, this message 
appears in the "Image Name" column: 


som SWAPPED QUT 


Format 
Qualifiers Defaults 
None None 
Parameters 
None 
Examples 
1. SUA> SHOW SUMMARY 


Figure 5-14 shows the display produced by this command. 


SDA COMMANDS 


VAX/VMS 2.0 -- System Dump Analysis 
Current process summary 


21-MAY-1979 15:36:26.03 


PID PROCESS NAME IMAGE NAME STATE PRI UIC WKSET 
00010000 NULL COM 0 [000,000] 0 
00010001 SWAPPER HIB 16 [000,000] 0 
00010019 TTA3: DBAO: [SYSEXE] VMOUNT.EXE; LEF 4 [017,022] 59 
0003001A TTF7: DBAO: [SYSEXE] MAIL. EXE; CoM 4 [320,100] 74 
0005001B MANDERLEY DBAO: [SYSEXE] RSX.EXE; LEF 7 [360,007] 148 
000B001C TTAL: DBAO: [SYSEXE] LOGINOUT.EXE; LEF 4 [010,040] 39 
0014001D KAREN LEF 4 [361,006] 41 
OOOCOO1E CRAIG DBAO: [SYSEXE] BACKTRANS .EXE; LEF 4 [320,111] 70 
OO001001F DERF LEF 8 [320,114] 41 
000B0020 USER LEF 7 [304,003] 150 
00100021 NOAH DBAO: [SYSEXE] LOGINOUT.EXE; LEF 7 [361,002] 67 
00050022 LYNN DBAO: [SYSEXE] SUBMIT.EXE;8 LEF 4 [320,110] 68 
001E0023 LAMONT DBAO: [SYSEXE] SHOW. EXE; LEF 4 [360,003] 61 
00170024 OZZIE DBAO: [SYSEXE] TYPE.EXE; 31 LEF 4 [360,002] 70 
00060025 CLEO DBAO: [SYSEXE] DELETE.EXE;4 LEF 4 [361,004] 68 
00020026 MAJA DBAO: [SYSEXE] COPY.EXE; LEF 4 [304,002] 55 
00170027 BOUSQUET DBAO: [SYSEXE] TALK .EXE; LEF 4 [011,016] 53 
00020028 BACH LEF 7 [360,016] 45 
00040029 WIZARD DBAO: [SYSEXE] BACKTRANS EXE; LEF 5 [017,022] 149 
000F002A BOUFFON COM 4 [300,041] 300 
000B002B HARLEY DBAO: [SYSEXE] SHOW. EXE; LEF 4 [017,022] 58 
0018002C DAVIDSON DBAO : [SYSEXE] BACKTRANS ..EXE; LEF 8 [361,013] 43 
OOOFO02D RMS DBAO: [SYSEXE] COPY.EXE; LEF 4 [011,0161 70 
0007002E TTG4: DBAO: [SYSEXE] DISPLAY .EXE; LEF 7 [311,001] 39 
0013002F KURT --- SWAPPED OUT --- LEFO 4 [361,003] 61 
000F0030 MEYERS LEF 4 [360,005] 65 
000F0031 EDWIN LEF 8 [360,001] 150 
00040032 TTG3: --- SWAPPED OUT --- LEFO 4 [311,001] 45 
00090033 WOODROW DBAO: [SYSEXE] USERS .EXE; LEF 4 [201,201] 50 
00200034 FRED DB2: [F4V2.TOOL] BLISS32.EXE;43 CUR 5 [320,100] 338 
00190035 REID --- SWAPPED OUT --- LEFO 7 [361,010] 106 
00160036 LOWELL LEF 5 [301,021] 45 
00210037 OPPENHEIM --- SWAPPED OUT --- LEFO 4 [360,023] 43 
00010038 NETACP HIB 9 [001,001] 54 
00010039 PRTSYMB4 DBAO: [SYSEXE] PRTSMB.EXE; HIB 8 [001,004] 41 
0001003A PRTSYMB3 DBAO: [SYSEXE] PRTSMB.EXE; HIB 8 [001,004] 41 
0001003B PRTSYMB2 DBAO: [SYSEXE] PRTSMB.EXE; HIB 8 [001,004] 41 
0001003C PRTSYMB1 DBAO: [SYSEXE] PRTSMB.EXE; HIB 8 [001,004] 41 
0001003D DBA2ACP DBAO: [SYSEXE] F11BACP EXE; HIB 11 [001,003] 104 
0031003E GUITAR HIB 7 [361,010] 32 
0001003F ERRFMT HIB 9 [001,006] 30 
00010040 OPCcoM LEF 8 [001,004] 38 
00010041 JOB CONTROL HIB 13 [001,004] 100 
00010042 DBAOACP HIB 11 [001,003] 100 
00020043 DBALACP DBAO: [SYSEXE] F11BACP.EXE; HIB 10 [001,003] 105 
Figure 5-14 Summary of Active Processes 
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SDA COMMANDS 


SHOW SYMBOL 


The SHOW SYMBOL command displays a local or global symbol and_ the 
value associated with it. If the value is a valid memory location, 
SDA examines that address and displays its contents. 

Format 


SHOW SYMBOL symbol-name 


Qualifiers Defaults 
/ALL None 
Parameters 


symbol-name 


Specifies an SDA symbol that corresponds to an SDA expression. 
See Section 4.2.5 for more information on SDA symbols. 


Qualifiers 
/ALL 


Displays two lists of the entire SDA symbol table. The first 
list organizes the local and global symbols in alphabetical 
order. The second list organizes these symbols by their values, 
Starting at the lowest value. If the value represents an 
address, the contents of the memory location will be displayed: 


TTY#AL CTRL GOOORALS => OQOONSASE 
If you specify a symbol name and the /ALL qualifier, SHOW SYMBOL 
displays a list of all the symbols that begin with the specified 
symbol name. For example, SHOW SYMBOL IOCSGL displays all the 
symbols with starting characters IOCSGL,. 


Examples 


1. SAS SHOW SYMBOL BUGSFATAL. 
BUGSFATAL = BO008256 ¢ OBBOSR OE 


In this example, the global symbol, its system virtual address, 
and the value stored at the address are shown. 


2. SIA QEFINE START = 90000000 
SUAS SHOW SYMBOL START 
START = OOOO0000 ¢ OO9ADLZIA 
In this example, a local symbol is defined. See the description 
of the DEFINE command for more information about symbol 
definition. 

3. S0AS SHOW SYMBOL ZALL 


Figure 5-15 shows a page of the listing produced by this command. 


CS-S 


VAX/VMS 2.0 -- System Dump Analysis 
System global symbols by name 


IOSM FCODE 

I0$ LOGICAL 
IO$ PHYSICAL 
I0$_READLBLK 
IO$_READPBLK 
IO$ READVBLK 
IOS WRITELBLK 
I0$ WRITEPBLK 
IOS WRITEVBLK 
IOCSALOUBAMAP 
IOCSALOUBAMAPN 
IOCSALTUBAMAP 
IOCSAPPLYECC 
IOCSCANCELIO 
LOCSCREATE UCB 
LOCSCVTLOGPHY 
LOCSCVT DEVNAM 
IOCSDELMBX 
IOCSDIAGBUFILL 
IOCSDIRPOST1 
LOCSDISMOUNT 
IOCSFFCHAN 
IOCSFILSPT 
IOC$GL_ADPLIST 
IOCSGL_AQBLIST 
IOCSGL DEVLIST 
IOCSGL_DIALUP 
IOC$GL_DPTLIST 
IOCSGL IRPBL 
IOCSGL_IRPFL 
IOC$GL_MUTEX 
IOCSGL PSBL 
IOC$GL_PSFL 
IOCSGQ BRDCST 


LOCSGQ MOUNTLST 


IOCSGW MAXBUF 


IOCSGW MBXBFQUO 


IOC$GW_MBXMXMSG 
IOC$GW_MBXNMMSG 
IOCSINITDRV 
IOCS INITIATE 
IOC$ LOPOST 

IOC$ LOADMBAMAP 
IOC$ LOADUBAMAP 
IOCSMAPVBLK 
ILOC$MOVFRUSER 
IOCSMOVTOUSER 
IOC$PTETOPFN 
IOCSQNXTSEG 
IOCSQNXTSEG1 
IOCS$REINITDRV 
IOC$RELCHAN 
IOCSRELDATAP 
IOC$RELMAPREG 
IOC$RELSCHAN 


0000003F 
0000002F 
OO00001F 
00000021 
0000000C 
00000031 
00000020 
0000000B 
00000030 


8000A807 = 


8000A803 
B000A7E5 
8000A8AC 
8000A551 
8000B7F6 
8000A920 
8000B87A 
8000A568 
8000ASEE 
80005544 
8000B665 
8000B8AF 
8000A3C0 
8000083C 
80003A10 
80000838 
80003A1C 
80000840 
80003A0C 
80003A08 
80003B28 
80003A04 
80003A00 
80003A20 
80003A14 
80004466 
80004468 
8000446A 


8000446C = 


800126FF 


S8OO0A6F4 = 


80005078 
8000AA04 
8000AA4E 
8000A947 
8000A388 
8000A3A4 
8000AAB7 
800053C0 


800053CC = 


80012705 


8000A628 = 


8000A7 29 
8000A799 


SO000A61E = 


A53C38BB 
151138BB 
5326Al19A 
C53C18BB 
58A508El 
5108A53C 
34A350D0 
DO7E507D 
5024A5D0 
534CA5D0 
5024AS5D0 
A6D028BB 
463BEFC1 
04C553DD 
8005E800 
80063310 
80000848 
800688A0 
80069090 
8007B390 
80076F70 
OOOOFFFF 
80003A00 
80003A00 
80003A20 
80056A60 
04000400 
01000400 
00100100 
00100010 


4CA553D0 
7D7E547D 
A53C53DD 
3C7E537D 
120AA291 
A5A8 3610 
A5A81A10 
OO0008FCA 
5218A3D0 
3044A4B7 


SO20A5D0 
5020A5D0 
5120A5D0 
5020A5D0 


IOCSREQCOM 
IOCSREQDATAP 
IOCSREQDATAPNW 
IOCSREQMAPREG 
IOCSREQPCHANH 
IOCSREOPCHANL 
IOCSREQSCHANH 
IOCSREQSCHANL 
ILOCSRETURN 
IOCSSEARCHDEV 
IOCSSEARCHGEN 
IOCSUNLOCK 
IOCSUPDATRANSP 
IOCSVERIFYCHAN 
IOCSWAKACP 
LOCSWFIKPCH 
IOCSWFIRLCH 
IPL$_ASTDEL 
IPL$_HWCLK 
IPLS IOPOST 
IPL$_ MAILBOX 
IPL$ POWER 
IPL$ QUEUEAST 
IPL$ SCHED 
IPL$_ SYNCH 
IPL$ TIMER 
KFISGL F11AACP 
LIBSCVT_DTB 
LIBSCVT HTB 
LIBSCVT_OTB 
LOGSAL_DISKLOG 
LOGSAL LOGTBL 
LOGSAL MUTEX 
LOGSDELETE 
LOGSGL SLTFL 
LOGS INSLOGN 
LOGSLOCKR 
LOGS$LOCKW 
LOGSSEARCHLOG 


LOGSTRNSLOGNAME 


LOGSUNLOCK 
MBSDDT 
MBSDPT 

MBSGL DDB 
MBSGL UCBl 
MBSGL_UCB2 
MBSUCBO 

MBAS INITIAL 
MBAS INT 
MMGSALCPAGFIL 
MMGSALCPHD 
MMGSALCSTX 
MMGSALLOCPFN 


MMGSAL_BEGDRIVE 
MMGSAL_ENDDRIVE 


Figure 5-15 


8000A6B3 
8000A762 
8000A75E 
8000A7D3 
8000A67F 
8000A688 
8000A66B 
8000A675 
8000A869 
8000B8D6 
8000B8DB 
8000B9F9 
8000A9C8 
8000BA0B 
800053F4 
S8O000A86A 
8000A88A 
00000002 
00000018 
00000004 


. OOOOOODOB 


OO00001F 
00000006 
00000003 
00000007 
00000007 


80003B40 = 


SO00FO3E 
8000F04C 


8000F045 = 


80011A08 


800039C8 = 


800039D4 
8000BA3E 
800039E8 
8000BA60 
8000BAA7 
8000BAAD 
8000BAC8 
8000BB14 
8000BAB3 
8000127C 
80000F34 
80000BE4 
80000C90 
80000D04 
80000C1C 
80001271 
80001200 
80006FFD 
8000BD5E 
8000BD35 
80006B82 
80001200 
80002E00 


=> 


21-MAY-1979 16:04:51.71 


534CAS5DO 
AS5DO01DD 
021100DD 
50E83210 
5020A5D0 
5020A5D0 
5020A5D0 
5020ASD0 
6EO02C005 
115202D0 
BB5201D0 
EFDO5SODD 
6 EAS5SOA2 
13500FAA 
DA7E12DB 
7DAEO2CO 
7D6E02C0 


80056830 
OADO003C 
10D0003C 
O8D0003C 


800039E8 
OOOOFFFF 
DO50610F 
80056A30 
530BA59A 
DF64CF9F 
DF44CF9F 
00608FBB 
1350613C 
DFB7CF9F 
0000031B 
80001046 
80000D78 
80000C90 
80000D04 
80000C1C 
04A401D0 
5300BEDO 
16DF41D0 
5024A532 
5126A532 
923052D4 
5300BEDO 
01AD0983 


Global Symbols 


MMGSAL PGDCOD 


MMGSAL PGDCODEN 


MMGSAL SBICONF 
MMGSAL SYSPCB 
MMGSA ENDVEC 
MMGSA_PAGFIL 
MMGSA SYSPARAM 
MMGSCRECOM1 
MMGSCRECOM2 
MMGSCREPAG 
MMGSCRETVA 
MMGSDALCPAGFIL 
MMGSDALCSTX 
MMGSDALCSTXSCN 
MMGS$DALLOCPEN 
MMG SDECPHDREF 
MMGSDECPHDREF] 
MMGSDECPTREF 
MMGSDECSECREF 
MMG S$ DELCONPFN 
MMGSDELGBLSEC 
MMGSDELGBLWCB 
MMGSDELPFNLST 
MMGSDELWSLEPPG 
MMG $ DELWSLEX 
MMGSDGBLSC1 
MMGSEXTRADYNWS 
MMGS$ FREWSLE 
MMG $ FREWSLX 
MMGS FRSTRONLY 
MMGSGETPTIPAG 
MMGSGL CRDCNT 


MMGSGL CTLBASVA 


MMGSGL FRESVA 
MMGSGL GPTBASE 
MMGSGL GPTE 
MMGSGL_IACLOCK 
MMGSGL MAXGPTE 
MMGSGL MAXPFN 


MMGSGL_MAXSYSVA 
MMGSGL_NPAGEDYN 


MMGSGL PAGEDYN 


MMGSGL_PAGSWPVC 


MMGSGL PFNLOCK 


MMGSGL PHYPGCNT 


MMGSGL RMSBASE 
MMGSGL SBR 
MMGSGL_SPTBASE 
MMGSGL SPTLEN 
MMGSGL SYSPHD 


MMGSGL SYSPHDLN 


MMGSGSDMTXULK 
MMGSGSDSCN 

MMGS$ IMGACTBUF 
MMGS IMGHDRBUF 


8000B400 
80011000 
80003264 
800038D8 
80000600 
800031D8 
80004400 
8000C39F 
8000C3A7 
8000C51D 
8000C380 
800070C4 
8000BDLE 
8000BCA5 
80006D23 
80006B2C 
80006B30 
80006AC5 
8000712E 
80006B97 
80007963 
8000D639 
80006Cc8C 
800069B9 
80006995 
8000D518 
800076B0 
8000682F 
800067E7 
80004800 
80007A12 
80003F30 
80004540 
80004558 
8000454C 
80004550 
80002E84 
80004554 
80004584 
80004558 
8000457C 
80004580 
80003218 
80002E88 
8000445E 
800032A4 
80004578 
8000455C 
80004560 
80004564 
80004568 
8000D503 
8000D599 
7FFEDAOO 
7FFEE200 


DSOOCF31 


00000000 
800038D8 
0000007A 
80060B7C 
EOBECC20 
547D5510 
DAOOEE30 
1EE150DD 
AC9A0LFC 
4FDF41D0 
5520A5Cl 
3AAS501E7 
40B552D4 
5146A53C 
2BDF41B7 
531509EF 
5520A5C1 
F8DF40D0 
501CA3D0 
6409FFOF 
10889610 
A4B70710 
526541D0 
071100FC 
A56CA5A3 
EF327E7C 
7E7CO1DD 
£15622DB 
DD7E12DB 
00000001 
7FFDFE00 
80200000 
801F9000 
801FD000 
00000000 
80200000 
00000E17 
80200000 
8005E800 
80056800 
8000322C 
40000000 
00004000 
80019C00 
001FC000 
801F9000 
00001000 
801F8400 
00000c00 
SC1BEFDO 
51D5527C 
00000000 
7FFEE208 
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CHAPTER 6 


ANALYZING SYSTEM FAILURES ~-- GUIDELINES AND EXAMPLES 


This chapter discusses how VAX/VMS handles internal errors’ and 
Suggests procedures that can aid in determining the cause of these 
errors. The final sections of the chapter illustrate, through 
detailed analysis of a sample system failure, how SDA helps you find 
operating system problems. 


6.1 GENERAL PROCEDURE FOR SOLVING SYSTEM FAILURES 


When the VAX/VMS operating system detects an internal error So severe 
that normal operation cannot continue, it signals a condition Known as 
a fatal bugcheck and shuts itself down. A bugcheck describes’~ the 
error discovered by the system; each error is associated with a 
particular bugcheck code. 


To resolve the condition, you must find the reason for the bugcheck. 
You generally need the VAX/VMS source code to locate the error, unless 
the error exists in a driver that is not supplied by DIGITAL. If this 
is the case, you may simply need the driver listings. 


The best way to start the search for the error is to locate the line 
of code that signaled the bugcheck. The address of this instruction 
is usually contained in the Program Counter register (PC). Invoke SDA 
and give the SHOW CRASH command. The display SDA produces gives the 
contents of the PC. 


Next, examine the system map file SYSSSYSTEM:SYS.MAP. This file lists 
the addresses of each VAX/VMS module that resides in system space (the 
part of the operating system that performs basic system services’ and 
scheduling). Compare the address in the PC with the addresses in the 
system map file to locate the module that uses the instruction pointed 
to by the PC. 


If you do not have the system map file, you can use _ SDA's~ symbol 
table. All the System global symbols that appear in SYS.MAP also 
exist in the SYS.STB file that SDA reads during the initialization 
process, To determine the offset from the closest global symbol, 
issue the command: 


Sia EXAMINE @FC 
Once you have narrowed the search to a particular module, subtract the 


module's starting address from the address in the PC to get the offset 
into the code. 


Now, to determine the general cause of the system failure, examine the 
code that signaled the bugcheck. 


ANALYZING SYSTEM FAILURES -- GUIDELINES AND EXAMPLES 


6.2 FATAL BUGCHECK CONDITIONS 


If a bugcheck is signaled, it is usually caused by one of two 
conditions: | 


e A fatal exception 


e An illegal page fault 


6.2.1 Fatal Exceptions 


A fatal exception is an event that causes VAX/VMS to signal ae fatal 
bugcheck. An exception is fatal when it occurs while a process is: 


e Using the interrupt stack 
e Executing above IPL 2 (IPLS ASTDEL) 


e Executing in a privileged (kernel or executive) processor 
access mode 


When the system fails, it lists the immediate cause of the failure on 
the LSI-11 console. For fatal exceptions, the messages appear as 
follows: 


FATALEXCFT» Fatal executive or kernel mode excertion 
INVEXCEF TN: Excertion while above ASTIEL or on interrurt stack 


Although there are several possible exception conditions, the type 
that most commonly occurs is the access violation. The rest of this 
section discusses the access violation in detail. For more 
information on other kinds of exceptions, see the VAX-11l Run-Time 
Library Reference Manual. 


When an access violation is detected by the VAX-1l hardware, 
information useful in finding the cause of the violation is pushed 
onto the current operating stack, that is, the stack that the process 
was uSing when the access violation occurred. This information is 
described by three structures, referred to as vectors. A vector is 
structured as follows: 


31 0 


longword 


series of 
longwords 
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The first longword in the vector shows the number of longwords” that 
follow. Each longword in the series contains information describing 
conditions at the time of the exception. 


The first vector that appears on the stack gives the addresses of the 
next two vectors: 


31 0 


Uae educa aediaest haan daign adehabeduenttboae rei aa ncledineticay sc aanomuiliientetess Uae oneaeceteesie cin texan coe ate toa me intenesaidibcn fear ae re rae ne a 






00000002 





; Sse! eenteemnan deren ace nvaeiteeecimniteeatthih. at. 


signal vector 
address 
mechanism vector 
address 


EH FORGES SAAMI Qe OS ROS AE PE TRF CE “2 TNE TAT OORT EPEC PP TEP MS PET PCP TMT HT 





The mechanism vector follows the first vector. This structure 
describes the process that was executing when the exception occurred. 
The diagram below illustrates the sequence of longwords in a mechanism 
vector: 


31 0 


OREN RETF LN TE TET RTT TO a EE PPERTS <— tA SE tr RE TR te PERS ORE 6 ALTERNA PT SE OTRO Sh = 






00000004 





baal ALO AAA ARERR FaligR GRAS WEE TATTOO WET HES. Bere MMT 5 oh RT : NO AS TEM AERO ORT rt EES A ROR | ON ARAM. ET STE IGT RRR RT a 


frame 


CAIN RARE TRENBORERO EST TN AE CR Ne EC NRO A A URRY! PAC 1 ENR PC A NL A REAPS RE A ROAR NRA A RAI AEE EMG SC ONLI": MERRIE 


depth 


HO RCA SPO SE ENEMA «UNI IIE FS RWIS Ro SRE NY See ta iadanainageteteegmanabiemeoneheuneiuraiee rae untoniaeen nee TOR a ee a ea a 


RO 


The values contained in this vector are: 


e 00000004 -- the number of longwords that follow. In a 
mechanism vector, this value is always four. 


e Frame -- the address of the stack frame. 
e Depth -- the stack depth. 
e RO -- the contents of RO at the time of the exception. 


e Rl -- the contents of Rl at the time of the exception. 
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The next vector created on the stack is the signal vector. For access 
violations, the signal vector is set up as follows: 


31 0 


gi oat cede gids ad tgiebuskge on Datiae aiden es Game ammarioe: Sota? aye ee De nr Re che Ne HR EH mag rat SER ooh ERTIES RTGS RCT ESOT | REN RE EE 


00000005 






ee ee ee ee Se eee Tro rk cere tt nt ener. Sere nn {Te ap Se PTAC EINES TT 1 ERD RARE ENSAYO ICT CETTE eR AMM ME MERTENS EERO PTSD SS A AN 


0000000C 






aha: ets MR RNRERNS RHO MBE. rc eC IEC NET i lah EET MRR nb Aelle Cee S: ¢ AS RNS RESEARCH darn PRON AM te SA AP APRN OCU IAD STON ORR aN AC et eR RRS A ATEN RESO I ES CNY AR CREED. ARE ET SESAME ANI 


reason mask 


SR At: a! SE ARENT OER SEES PS GRE SERRE RR SE i MRA A AN Net 2 EPRI SHO ti tm 





SEN eS AS EERO TOPE NOMENON ERIRRL “EARTHED TET HRA TEST TET, MR TENA TONITE SS 


virtual address 


en et AAAI ne AAA RE aD = me a On Aa ON Me Bc RSE DS UREA Am AAAI RST: OREN GRIA MR RG, ARR OARS SER POOR ROLE 


PC 


Sa MMNTES NR OAR nA LD TUR AOMORI OFT TOT EATER hc TERE AOS PS RT FRONER TORN A 


PSL 


SETA REO ON NE ENE CER SS LINO ETA Be oT ARRIETA RRR E, RLS OREN AYRE OEMS HST AT er 


The parameters shown in the above diagram are: 


e 00000005 -- the number of longwords that follow. For access 
violations, this value is always five. 


e oO000000C -- the exception code. This value is C (hexadecimal) 
to represent an access violation. 


@ Reason mask ~-- the longword whose lowest three bits, if set, 
indicate that the instruction caused a length violation (bit 
0), referenced the process page table (bit 1), and attempted a 
read/modify operation (bit 2). 


@e Virtual address -- the virtual address that the system tried 
to reference. 


@® PC -- the Program Counter. The PC contains the address of the 
instruction that signaled the exception. 


e PSL -- the processor status longword at the time of the 
exception. 


Signal vectors differ in length, depending on the kind of exception 
the system detects. See the VAX-11 Run-Time Library Reference Manual 
for details. 


If VAX/VMS encounters a fatal exception, you can find the code that 
Signaled it by examining the PC placed in the signal vector. Issue 
the SHOW STACK command to display the current operating stack, then 
locate the vectors. Once you obtain the PC, which points to the 
instruction that signaled the exception, you can identify the module 
by the procedure outlined in Section 6.1. 
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6.2.2 Illegal Page Faults 
VAX/VMS also signals a bugcheck when a page fault occurs while the 
Interrupt Priority Level (IPL) is greater than two (IRPS ASTDEL). 


When VAX/VMS fails because of an illegal page fault, it issues’ the 
following message on the console: 


PGFIFLHIs Fase fault with IFL too high 


In this case, information is pushed on the stack as longwords in the 
following sequence: 


31 0 
R4 
R5 


reason mask 


virtual address 








The longwords pushed on the stack are: 


e R4-- the contents of R4 at the time of the bugcheck. 

e R5 -- the contents of R5 at the time of the bugcheck. 

e Reason mask -- see Section 6.2.1. 

e Virtual address -- the virtual address that caused the page 
fault. 

e PC -- the Program Counter. The PC contains the address of the 
instruction that was executing when the page fault was issued. 

e PSL -- the processor status longword at the time of the 
bugcheck. 


If the operating system detects a page fault while the IPL is higher 
than two, you can obtain the faulting instruction by examining the PC 
pushed on the current operating stack. Follow the steps outlined in 
Section 6.1 to determine which module issued the instruction. 
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6.3 DEBUGGING A SYSTEM FAILURE -- AN EXAMPLE 


This section steps through the analysis of a system failure. The 
events that lead up to this failure are: 


e The line printer goes offline for three hours. 
@e The line printer comes back online. 


e The operating system signals a bugcheck, writes information to 
the system dump file, and shuts itself down. 


6.3.1 Identifying the Bugcheck 


Invoke SDA to analyze the system dump file. The initialization 
message indicates the type of bugcheck signaled: 


VAX/VNS System dumre analyzer 
lume taken om 31-JUL-1979 20343313.32 
INVEXCEF TN: Excertion while above ASTIIEL or on interrupt stack 
SIIA 
VAX/VMS encountered an exception that caused it to signal a_ bugcheck. 


Signal and mechanism vectors are created on the current operating 
Stack. 


6.3.2 Identifying the Exception 

Issue the SHOW STACK command to display the current operating stack, 
which, in this case, is the interrupt stack. Figure 6-1 shows the 
interrupt stack and highlights the three vectors. 


Current orerating stack CINTERRUFT) 


80060378 80008448 ACFSWRITEBLK+OA0 
SF 80060398  7FFNC340 
BO06A39C BO06AZA0 
8006A3A0 80004E71 EXESRELECT+O04 
80060304 04080009 







800605 AR a 


mechanism 
vector 30046ASBO. 
: 800603 B4 ~ B0017 
SO06A3B8 6000074 - 
B006ARBERE 00000005 
(B006A3CO 00000000. 
signal *BO0GASCA 0000 . 
vector 





-B006A3D0 04080000 
SOOS6ASTI4A 80009604 EXE SPORKISE THAO LC 


> 


Figure 6-1 Interrupt Stack and Vectors 
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Examination of the signal vector shows that: 


e The exception code is C (hexadecimal) which means that an 
access violation occurred. 


e The reason mask is zero, which means that the instruction 
generated a protection violation (instead of a length 
violation) when it tried to read the location (rather than 
write to it). 


e The virtual address is 80069E00 and is the address that the 
instruction tried to reference. 


e The PC is 8005D003 and is the address of the instruction that 
signaled the exception. 


e The IPL was eight at the time of the exception (shown by bits 
16 through 20 of the PSL). 


e The current operating stack was the interrupt stack (bit 26 of 
the PSL is set to l). 


e The process was executing in kernel mode at the time of the 
exception (Shown by bits 24 and 25 of the PSL). 


Use the SHOW PAGE TABLE command to display the system page table, as 
shown in Figure 6-2. The page containing location 80069E00 is not 
available to any access mode (a null page); thus, the virtual address 
is not valid. 


VAX/VMS 1,@ == System Dump Anelysis 
Syetem page table 


ADDRESS 


SVAPTE PTE 






Baacd34a 





BUSbABRH B@@GaSED 
BYBSALZBOA RA0CO344 BUBBBSEE 
ermnmaevaws 1 NULL PAGE 

BAB6A6RY BHACD34C 04828389 
BABGABBA BUACO3Sa Danauiag 
BAAbAAGB Baacod3ssS4 Ddaagvnedb 


eae age eqs. @ 3 NULL PAGES 


8YG6B29a BYYCD364 OUBAYBAT 
AGALBABA BYACD368 Dugaad4e 
82868 64u BAPCO3S6C O4SAH4AB 
AAa6RBauU BUBCO37a Davagers 
Ag AbRAQA BAUCD374 SaBaAnue 
8236BC aA BABCO378 Sangaaay 
BADSBERD BYACO37C Sanaaaua 
B8AG6C 98 BAACHSBA Sea@hunne 
823602239 8400384 Seadaasa 
87@b6Cuaau BAVCD3S68 SAABUNAPA 
BaAroC EAU BUACDSBC Saaaunava 
B426C82A BUACD392 Sasauaae 
APBECADB AVACD39u Saaavava 
BYb6CCOB BYACOS9R SAAAAAIAA 
BAABCEAY RAAQCD39C Sanavare 
Ay godZan BAACOSAG Sageaadae 
AAAGD2AA BYACD3SAG SanaKALA 
BAAD AA BACCOSAB Sagsveune 
BAGeDSBA AUACOSAC Sagzaasr 
BABEDBAA BuGCO3SBA Saragenvie 
Bagedana BAACD3B4 Sagaun ie 
Be 6DCOA BAACDSBSB Saanavace 
BAYVENE RO AsBCDSAC SeAQavere 
BVAGE Ra BOACH3Ca Sa@anaave 
BGAbE2By B4ACD3CH SQuanvur 
Raeeb age BALCOSCR SavOnaae 
BYUAb6E eae SRACOSCC Sagaagre 
BEOSEBBA 84ACD30e SaheLAve 
BAGHEARA BAACD304G SaABABUYE 
BSAbECBO 8HACD3SD8 Saeagveny 
SXUAGEEDSA BBACO3DC DUBGAeES 
BOAGF IBD REACDSER D4G88353 
BAP FARA S83@CD3E4 Sapanane 
8euork aga B@ACDO3ES D4@99194 
B2B6F 6Qu 8XACD3EC D4anaesD 
BAGEF BRA 88A@CD3FQ D4uBD122 


Seva euew 3 NULL PAGES 


Figure 6-2 


TYPE 


VALIO 
VALIO 


VALID 
VALID 
VALID 


VALID 
VALID 
VALID 
VALID 
DZERO 
DZERN 
NONZERO 
DZERI 
ZERO 
DZERN 
AZERO 
DZERO 
OZERD 
VZERD 
DZERD 
DZERD 
NZEPO 
DZERO 
DZEFO 
NZERQ 
NZERN 
OZERV 
DZERU 
NZERPD 
DZERN 
OZERO 
NZERO 
AZERO 
QZERO 
OZERO 
VALID 
vALID 
NZERD 
VALID 
VALIO 
VALID 


PROT 


ERKW 
ERKW 


SRKW 
SRKW 
SRKW 


SRKW 
SRKW 
SRKW 
SRKW 
SRK 
SRKW 
SRKW 
SRKW 
SR KW 
SRKwW 
SRKW 
SRKW 
SR KW 
SRKW 
Saka 
SRKW 
SRKw 
SRK w 
SRKW 
SRKW 
SRKW 
SRKia 
SRKW 
SRKWA 
SRKW 
SRK 
SRKwW 
SRK WwW 
SRKW 
SRK W 
SRKWw 
SRKW 
SRKW 
SRKW 
SRKwW 
SRKwW 


xz 


=z 


BITS 


KKK 


RR MRR RMR KR RRR RRR RR RR KR ROKR KR KR KR KKH A KR RRR KR KK 


Page Table Display 


PAGTYP 


PPGTBL 
PPGTBL 
PPGTAL 


PPGTBL 
PPGTBL 
PPGTRL 
PPGTBL 


PPGTAL 
PFGTBL 


PeEGTSL 
PPGTBL 
PPGTBL 


LOC STATE TYPE 


ACTIVE 
ACTIVE 
ACTIVE 


ACTIVE 
ACTIVE 
ACTIVE 
ACTIVE 


ACTIVE 
ACTIVE 


ACTIVE 
ACTIVE 
ACTIVE 


1A@-DEC#1979 19321388,32 


87 
87 
87 


87 
8&7 
87 
87 


87 
87 


87 
87 
87 


@4 
Ag 
2g 


Au 
Bd 


Au 


OG 
ad 


a4 


gu 


REPCNT 


a 


ob oP Po He 


BAK 


asaenaee 
asaaueaa 
asoaueed 


a3saraaae 
BSQA24LA 
O33FFFFF 
a3ee264B 


A33FFFFF 
s3900000 


A3SGABABA 
J3QAbUBO 
83203900 


SVAPTE 


8agCO34C 
8aacd35e 
Baecd3ss4 


88aCD364 
8eacd3é68 
8aacd36c 
8aACD379 


B82acD3DC 
BBACD3EG 


8BAGCD3E8 
BABCDSEC 
82eCD3Fa 


Showing Invalid Location 80069E00 


Page 


FLINK 


8488 
A280 
8220 


8088 
9a35 
Q421 
9800 


a3ea3 
ABdE 


2008 
8aag 
e880 


17 


BLINK 


ABSA 
8048 
AB4C 


BAdD 
ABER 
@BE3 
6a8e 


A485 
BA4E 


AAGA 
BS4B 
Be4e 
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6.3.3 Locating the Source of the Exception 


Because the line printer went offline and then online, the problem may 
exist in the driver code. To determine which driver might contain the 
faulty code, take the address contained in the PC on the _ stack = and 
compare it with the bounds of each driver. 


6.3.3.1 Finding the Driver Using the DPT List - The Driver Prologue 
Table (DPT) is a data structure that describes each driver. All the 
driver prologue tables form a linked 1iSt; each DPT is’ followed 
directly by driver code. The location IOCSGL DPTLIST contains the 
address of the first DPT. Figure 6-3 illustrates the linked structure 
of the driver prologue tables. 





lIOC$GL__DPTLIST 
DPT 
DRIVER DRIVER DRIVER 
CODE CODE CODE 





——— RN sa Pe rey, 


Figure 6-3 Linked List of Driver Prologue Tables 
Use the FORMAT command and specify the contents of IOCSGL DPTLIST as a 
parameter: 
SoAS FORMATO TOCS#GL.WUP TL IST 


BOQSOGOO THE TB LPL TNX SQOGk Add 
8OOSOS04 Oe Tél. BOOWOOOO 










BOO GOGOA QE TSR TYRE 

BOOSOSOE DET $ RORERC 

BOOhOS00 DET BATE TY Fk 

SOOS6OS O71 QE T$ ROP LAGS 

SOO6OS0K Qe TSW.UCRS TZ OOF O 
B8OO6OS10 Qe TSWOINTT TAR OOF 
BO06OS12 Qe TBO RETIN I T TAR 0062 
BOO6OS 14 Oe TéWUNLOAT 0000 
BOOGOS16 De TS TOONAME "DED TV ERS" 
SOAS 
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The formatted display identifies the size of the driver by the symbol 
DPTSW_ SIZE. 


Calculate the end of the driver by adding the value of DPTSW_ SIZE to 
the starting address of the DPT for the driver. The driver code 
begins just after the DPT. 


Next, determine whether the address in the PC falls within the range 
of addresses that contain the driver code. If the address is not part 
of the driver you are examining, continue on to the next driver by 
stepping through the linked list with the FORMAT command (see the 
description of the FORMAT command in Chapter 5 for an example of the 
commands used to step through a linked list of data structures). 


In this example, the instruction that caused the exception falls 
within the range of addresses that contain the line printer driver 
code. 


6.3.3.2 Calculating the Offset into the Driver - Once you have 
identified the driver, you can locate the instruction in the source 
code by subtracting the starting address of the driver prologue table 
from the address contained in the PC. Match the resulting offset with 
the offsets in the driver code listing. 


After you have located the routine that caused the excevtion, you 
should examine memory to make sure that the instruction in the routine 
matches the instruction that signaled the exception. 


6.3.4 Finding the Problem within the Routine 


Examine the line printer driver code. The instruction that caused the 
exception is MOVB’ (R3)+,(RO), as shown in Figure 6-4. To check the 
contents of R3, use the SHOW CRASH command. The invalid virtual 
address 80069E00 is indeed stored in R3. 
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F5 
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6C 
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A5 
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94 
Al 


B4 
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O29F 482 
O29F 483 
02A3 484 
O2A7 485 
O2AC 486 
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O2B6 490 
O2B9 491 
O2BB 492 
O2BB 493 
O2BB 494 
O2BB 495 
O2BB 496 
02BB 497 


02C2 499 
02C8 500 
O2CC 501 
02D6 502 
O2DC 503 
O2DE 505 
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O2DE 508 
O2DE 509 
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O2E4 

O2E6 SLi 
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O2EE ol 
O2FO0 515 
O2F5 516 
O2F8 

O2FC 517 
O2FF 518 
0301 519 
0304 520 
030A 


Figure 6-4 


me 6% 


START NEXT OUTPUT SEQUENCE 


10S: ADDL3 #LP DBR,R4,RO CALCULATE ADDRESS OF DATA BUFFER REGISTER 
MOV ZWL UCBSW_BOFF(R5) ,R1l ;GET NUMBER OF CHARACTERS REMAINING 
MOVW #~xX8080 ,R2 >GET CONTROL REGISTER TEST MASK 
BRB 25S ; 

20S: BITW R2, (R4) »>PRINTER READY OR HAVE PAPER PROBLEM? 


BLEQ 


30$ 





;IF LEQ NOT READY OR PAPER PROBLEM 









NEXT CHARACTER 
258 SOBGEO R1,20$ sANY MORE CHARACTERS TO OUTPUT? 
BRB 70S ; 
; PRINTER IS NOT READY OR HAS PAPER PROBLEM 
30S: BNEQ 40s IF NEQ PAPER PROBLEM 
ADDW3 #1,R1,UCBSW_BOFF(R5) >SAVE NUMBER OF CHARACTERS REMAINING 


DSBINT 


; 
; PRINTER 


;DISABLE INTERRUPTS 
BISB #*x40,LP CSR(R4) ;SET INTERRUPTS 
WFIKPCH 40$,#12 — ;WAIT FOR INTERRUPT 
I OFORK ;CREATE A FORK PROCESS 


BRB 10$ : 


HAS PAPER PROBLEM 


CLRB UCBS$B LP OFLCNT(RS5) ;CLEAR OFFLINE COUNTER 

ADDW3 #1,R1,UCBSW_BOFF (R5) >;SAVE NUMBER OF CHARACTERS REMAINING 
CLRW LP CSR(R4) >DISABLE PRINTER INTERRUPT 

SETIPL UCBS$B FIPL(RS5) >LOWER TO FORK LEVEL 

TSTW LP CSR(R4) sPRINTER STILL HAVE PAPER PROBLEM? 
BGTR 10$ ;IF GTR NO 

BBS #UCBSV CANCEL,UCBSW STS(R5),80S ;IF SET, CANCEL I/O OPERATION 
ACBB #15,#1,UCB$B_LP OFLCNT(R5),80S ;SKIP UNTIL TIMEOUT 

CLRB UCBS$B LP OFLCNT(RS5) ;RESET COUNTER 

PUSHR #“M<R3,R4> ;SAVE REGISTERS 

MOVZBL #MSGS$ DEVOFFLIN,R4 ;SET UP MESSAGE TYPE 

MOVAB G“SYSSGL_OPRMBX,R3 :; ADDRESS TARGET MAILBOX 


Location of Instruction in Driver Routine 
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ANALYZING SYSTEM FAILURES -- GUIDELINES AND EXAMPLES 


6.3.4.1 Stepping through the Routine - The MOVB instruction is part 
of a routine that reads characters from a buffer and writes them out 
to the line printer. The routine executes the following steps’ for 
each character in the buffer: 


e The driver gets a character from the buffer, moves it to the 
device data register (pointed to by RO in this example), and 
autoincrements. 3 


e The preceding step is repeated until the byte count is 
exhausted or the printer signals that it is NOT READY. 


e If the printer gives the NOT READY signal, the driver waits 
for an interrupt from the printer. 


e When the printer becomes READY, it interrupts the driver and 
the loop is resumed. 


Examine the code to determine which variables control the loop. In 
this case, the byte count (BCNT) is the number of characters in the 
buffer. This value controls the number of times the loop is executed. 
(BCNT is set by a Function Decision Table (FDT) routine to the number 
of characters in the buffer.) The number of characters left to he 
printed is represented by the byte offset (BOFF). 


Because the exception is an access violation, you can infer that R3 is 
outside the range of the buffer. Tt seems likely that the MOVB 
instruction has executed too many times, that is, a number of times 


greater than BCNT, To prove this theory, you musSt examine BOFF and 
BCNT. 


6.3.4.2 Checking the Values of Key Variables - If you examine the 
code, you can see that R5 contains the address of the Unit Control 
Block (UCB) of the device that was active when the system failed. If 
you use the FORMAT command to display the contents of R5, SDA will 
display the values of BCNT and BOFF: 


SDA> FORMAT @RS 


B0050160 UCEBS$LRQFL. B00039AE8 
UCRSL._FQFL 

800501464 UCRS$I. RQ BO00O39AS 
UCRSL._FQBL 

80050168 UCKSW_STZE 0080 

B00S0D16A UCRSB. TYPE 10 

BSO0S014E UCRS ROP TRL O08 





fet oe os ‘ 3 MAGA 


UCESR 


S005 04 TL UCR ER TMAX OQ 
BOOST Le UCKSWWERRONT OOOO 
SOAs 


ANALYZING SYSTEM FAILURES -- GUIDELINES. AND EXAMPLES 


If you have only one line printer in your system configuration, you 
need not use the FORMAT command. Issue the SHOW DEVICE command with 
device code LP as the parameter; since there is only one line printer 
device connected to the VAX-11 processor there is only one line 
printer UCB to display. 


The output produced by the FORMAT @R5 command shows that BOFF contains 
a value greater than BCNT, when it should be the reverse. This means 
that an illegal value is being stored in BOFF. Thus, the value of 
BOFF is not the number of remaining characters in the buffer but some 
meaningless number that eventually causes the system to fail when it 
tries to access a null page (unreadable to all access modes). 


6.3.4.3 Identifying and Fixing the Defective Code - Examine the line 
printer driver code again to locate all instructions that modify BOFF. 
The value changes in two important places. 


1. Immediately after the driver detects that the printer is not 
ready. 


2. When the wait for interrupt (WFIKPCH) routine timeout count 
of 12 seconds is exhausted. At this time, Rl+l is stored in 
BOFF. 


The second modification to BOFF should not be made because R4 and R5 
are the only registers that retain their values after the WFIKPCH 
routine is executed. To correct the problem, change the WFIKPCH line 
to transfer control to 50S rather than 40S (see Figure 6-5) if the 
timeout count expires. 


vt-9 
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51 6C 
D2 8080 
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94 
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O29F 
02A3 
O2A7 
O2AC 
O2AE 
O2Bl1 
02B3 
02B6 
02B9 
O2BB 
O2BB 
O2BB 
02BB 
02BB 
O2BB 
O2BD 
02C0 
O02C2 
02C8 
02CC 
02D46 
O02DC 
O2DE 
O2DE 
O2DE 
O2DE 
O2E1 
O02E4 
02E6 
02E8 
O2EC 
O2EE 
O2F0 
O2F5 
O2F8 
O2FC 
O2FF 
0301 
0304 
030A 
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481 ; 
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483 10S: 
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487 20S: 
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490 25S: 
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493 ; 
494 ; 
495 ; 
496 

497 30S: 
498 
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506 ;! 
508 ¥ 
509 40 
510 


511 508: 
512 
513 


515 
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520 


Figure 6-5 


HOS: 2 pS SSeS 


START NEXT OUTPUT SEQUENCE 


ADDL3 #LP DBR,R4,RO0 

MOV ZWL UCBSW BOFF(R5) ,R1 
MOVW #~x8080 ,R2 

BRB 25S 

BITW R2,(R4) 

BLEO 30S 

MOVB (R3)+, (RO) 

SOBGEQ R1,20$ 

BRB 70S 


;CALCULATE ADDRESS OF DATA BUFFER REGISTER 
;GET NUMBER OF CHARACTERS REMAINING 

;GET CONTROL REGISTER TEST MASK 

;PRINTER READY OR HAVE PAPER PROBLEM? 

7;IF LEQ NOT READY OR PAPER PROBLEM 

; OUTPUT NEXT CHARACTER 

; ANY MORE CHARACTERS TO OUTPUT? 


td 


PRINTER IS NOT READY OR HAS PAPER PROBLEM 


BNEQ 40S 
ADDW3 


DSBINT 
BISB #7X40,LP_CSR(R4) 
WFIKPCH [40S], #12 

IOFORK 

BRB 






10S 


PRINTER| HAS PAPER PROBLEM 


#1,R1,UCBSW_BOFF(R5) 


;IF NEQ PAPER PROBLEM 
;SAVE NUMBER OF CHARACTERS REMAINING 


;DISABLE INTERRUPTS 
;SET INTERRUPTS 

;WAIT FOR INTERRUPT 
;CREATE A FORK PROCESS 


oe 
f 


CLRB UCBS$B LP OFLCNT(RS5) ;CLEAR OFFLINE COUNTER 

ADDW3 #1,R1,UCBSW_BOFF(R5) :;SAVE NUMBER OF CHARACTERS REMAINING 
foe ey LP _CSR(R4) ;DISABLE PRINTER INTERRUPT 

SETIPL UCBSB FIPL(R5) :LOWER TO FORK LEVEL 

TSTW LP CSR(R4) >PRINTER STILL HAVE PAPER PROBLEM? 

BGTR 10s ;IF GTR NO 

BBS #UCBSV CANCEL,UCBSW STS(R5),80$ ;IF SET, CANCEL I/O OPERATION 

ACBB #15,#1,UCBSB_LP_OFLCNT(R5),80$ ;SKIP UNTIL TIMEOUT 

CLRB UCBSB_LP_OFLCNT(R5) ;RESET COUNTER 

PUSHR #°~M<R3,R4> ;SAVE REGISTERS 

MOVZBL #MSGS DEVOFFLIN,R4 :SET UP MESSAGE TYPE 

MOVAB G“SYSSGL_OPRMBX,R3 ; ADDRESS TARGET MAILBOX 


Location of Defective Code in Driver Routine 
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ANALYZING SYSTEM FAILURES -- GUIDELINES AND EXAMPLES 


6.4 INDUCING A SYSTEM FAILURE 


If the operating system is not performing well and you want to create 
a system dump file so that you can examine it later, you can induce a 
system failure by typing the following commands at the console: 


}  GTRLIP) 
aiciems 
EXAMINE PSL, 
TEE OS a AG oe] 
QERPOSIT PSL = LFOOOO 
CONTINUE 


The system responds to the HALT command by displaying the PC; it 
responds to the EXAMINE PSL command by displaying the PSL. 
Immediately after you type this command sequence, the system signals a 
fatal bugcheck, writes information to SYSDUMP.DMP, shuts itself down, 
and automatically reboots. 


Make a note of the PC and PSL displayed on the console before you 
perform the procedure outlined above. When you induce a system 
failure, the values you deposit into these registers destroy their 
previous contents, and you will need the pre-failure values contained 
in the PC and PSL when you begin to examine the system dump file, as 
described in Section 6.1. 


CHAPTER 7 


SDA ERROR MESSAGES 


SDA error mesSages can be divided into messages that occur during SDA 
initialization and messages that occur during SDA operation. Messages 
that appear before SDA is initialized indicate problems encountered by 
SDA as it tries to run. SDA prints the message but does not execute. 
Messages that appear when SDA is operating concern problems 
encountered during command execution, | 


Tae INITIALIZATION ERROR MESSAGES 
Tne cume file contains mo valic cums 
This message appears if SDA cannot read the contents of the 


system dump file. The file may be unreadable because the data is 
bad or because the file is empty. 


The dume only contains m rages of ehusical memory 
This message occurs if the system dump file is not large enough 
to accommodate all of physical memory. The number of physical 
pages SDA can analyze is represented by n. To change the size of 
the system dump file, see Section 2.1. 


Symbol symbolename mot found in SUA sumhol table 


This message appears if SDA cannot find a symbol in the SYS.STB 
file which is vital to its initialization. 


7.2 OPERATIONAL ERROR MESSAGES 
Invalid block tyre in srecified block. 


This message appears if SDA is unable to identify the block type 
of a particular block. The invalid block type message most 
usually occurs when the FORMAT command tries to identify a block 
type uSing a byte offset. See the description of the FORMAT 
command in Chapter 5 for further information about byte offsets. 


No “block-tyure" symbols found to format this block 


This message appears if SDA cannot locate the symbols needed to 
format a block as a particular block type. 


You may need to use the READ command to include the _ specific 
block type symbols in the SDA symbol table. 


SDA ERROR MESSAGES 


No such rrocess 


This message occurs if the process name specified in a SHOW 
PROCESS or SET PROCESS command refers to a process that does not 
exist. 


Frocess swarred gut 


This message occurs if the process name specified in a SHOW 
PROCESS or SET PROCESS command represents a process that was 
Swapped out of the balance set when the system failed. 


Unable to gccess Location location 


This message indicates that SDA is unable to read a certain 
location. The inaccessible location may be an implied reference 
to memory made during the execution of an SDA command. 


Unknown symbol symbol-name 
This message occurs if SDA cannot identify a specified symbol. 
Unknown tyre of OST! entret GSti 


This message occurs when SDA encounters a type of global symbol 
that it does not recognize, either in the SYS.STB file or ina 
file specified in the READ command. The type of global _ symbol 
definition GSD is represented by a byte. This message can occur 
during either initialization or operation of SDA, and _ usually 
means that the file being read has been corrupted. 
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Illegal page faults, 
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Inducing system failure, 6-15 
Initialization error message, 7-l 
Interrupt Dispatch Block (IDB), 
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3-2 
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Key variables, checking values of, 


6-12 


L 


Line of code, and bugcheck, 4-1 
Linked lists, formatting, 5-12 
Linked structure of DPT, 6-9 
List, 
data structures, 5-24 
process's hardware context, 
Local symbol, displayed, 5-5l 
Local symbol value, displayed, 
5-51 
Location, 
contents displayed, 5-6 
examine by symbol, 3-4 
parameters, 5-6 
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Index-2 
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Mechanism vector, 6-3 
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5-36 
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4-1 


4-3 
Period (.), aS nonprinting charac- 
ters, 5-3 
PFN data base, displayed, 5-33 
PhySical page, 
displayed, 5-33 
information, 5-30 
/PO, aS EXAMINE qualifier, 5-7 
/P1, as EXAMINE qualifier, 5-7 


Preserving a system dump file, 
5-2 
Printing, 
both program and control 
regions, 5-7 
control region, 5-7 


I/O request packet pool, 5-36 


Printing, (Cont.) 
nonpaged dynamic storage pool, 
5-36 
paged dynamic storage pool, 5-37 
program region, 5-7 . 
Summary of the pools, 5-37 
writeable system region, 5-7 
Problem, finding, in routine, 
Process, 
context, 5-19 
control block 
header (PHD), 5-19 
identification (PID), 5-19 
information, in SHOW CRASH 
command, 5-21 
regions, displayed, 
register contents, 5-21 
Processor registers, loss of 
contents during SYSSDMP.DMP, 
3-2, 3-3 


6-10 


(PCB), 5-19 


5-6 
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Qualifier, 4-1 
abbreviated, 
multiple, 4-1 

Quotation marks (" "), 

ASCII text, 5-3 


4-1 


around 


R 


Radix operators, 4-2 
Radix, specifying SDA use, 
READ command, 5-15 
to create symbols, 4-3 
Reading dump file, prerequisites 
for, 3-1 
Register contents, 5-21 
REPEAT command, 5-17 
Return to interactive display, 
in SET OUTPUT command, 5-18 
Routine, finding problem in, 6-10 
Stepping through, 6-12 
RUN command, invoking SDA with, 
3-1 
Running system, examination of, 
3~2 


4-2 
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Sample crash analysis, 

screen overflow prompt, 
command, 5-10 

SDA, definition, 1-1 

command format, 4-1 

in site-specific start-up 
procedure, 3-4 


6-9 
and exit 
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SDA, definition, (Cont.) 
operation. See HELP command 
utility. See HELP command 

SET PROCESS command, 5-19 

SHOW CRASH command, 5-46 

SHOW CRASH display, 3-3 

SHOW DEVICE command, 5-24 

SHOW PAGE TABLE command, 5-29 

SHOW PFN DATA command, 5-33 

SHOW POOL command, 5-36 

SHOW PROCESS command, 5-39 

SHOW STACK command, 5-46 

SHOW SUMMARY command, 5-49 

SHOW SYMBOL command, 5-51 

Signal vector, 6-4 
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Slash (/), used with qualifier, 

4~] 

Software process context, 5-39 

Space, in expression, 5-3 

Special characters, 4-3 

Special operators, 4-3 

Special register contents, 5-21 

Special symbols, 4-3. See also 

DEFINE and READ commands 

Stack configuration for illegal 

page faults, 6-5 

Stacks, displayed, 5-46 

Stepping through routine, 6-12 

Step through linked list, 5-17 

Stopping SDA, 5-10 

SWAPFILES command procedure, 2-1] 

SYSSDISK default, 3-1 

Symbol evaluation, 5-5 

Symbols, 
add to table, 5-3 
asSign value to, 5-3 
defined, 4-3 
global, 5-3 

Symbol table, displayed, 5-51 

System dump file, 2-1 
calculating size of, 2-1 
creating new, 2-1 
default file specification, 3-1 
reading, 3-1 
saving, 2-l 
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debugging, 6-6 
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system, 3-2 
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solving, 6-1 
System map file, 
SYSSSYSTEM:SYS.MAP, 6-1. 
System parameter. See parameter 
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System region, displayed, 5-6 
System-wide interrupt stack, 
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Unary operators, 4-2 
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Writing output to a file, 5-18 
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READER'S COMMENTS 


This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
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